diff --git a/.claude/settings.json b/.claude/settings.json new file mode 100644 index 00000000000..91a59a86e0c --- /dev/null +++ b/.claude/settings.json @@ -0,0 +1,15 @@ +{ + "hooks": { + "PreToolUse": [ + { + "matcher": "Bash", + "hooks": [ + { + "type": "command", + "command": "jq -r '.tool_input.command // \"\"' | grep -qE '^git commit' && cd \"$CLAUDE_PROJECT_DIR\" && echo '🔍 Running pre-commit before commit...' && pre-commit run || true" + } + ] + } + ] + } +} diff --git a/.github/actions/change-detector/label-draft-pr.yml b/.github/actions/change-detector/label-draft-pr.yml index 01d09225b6c..0949cc2df37 100644 --- a/.github/actions/change-detector/label-draft-pr.yml +++ b/.github/actions/change-detector/label-draft-pr.yml @@ -10,7 +10,7 @@ jobs: steps: - name: Check if the PR is a draft id: check-draft - uses: actions/github-script@v6 + uses: actions/github-script@v8 with: script: | const isDraft = context.payload.pull_request.draft; diff --git a/.github/dependabot.yml b/.github/dependabot.yml index ae523f1ac53..c01258ea8b9 100644 --- a/.github/dependabot.yml +++ b/.github/dependabot.yml @@ -12,10 +12,17 @@ updates: # not until React >= 18.0.0 - dependency-name: "storybook" - dependency-name: "@storybook*" + # remark-gfm v4+ requires react-markdown v9+, which needs React 18 + - dependency-name: "remark-gfm" + - dependency-name: "react-markdown" # JSDOM v30 doesn't play well with Jest v30 # Source: https://jestjs.io/blog#known-issues # GH thread: https://github.com/jsdom/jsdom/issues/3492 - dependency-name: "jest-environment-jsdom" + # `@swc/plugin-transform-imports` doesn't work with current Webpack-SWC hybrid setup + # See https://github.com/apache/superset/pull/37384#issuecomment-3793991389 + # TODO: remove the plugin once Lodash usage has been migrated to a more readily tree-shakeable alternative + - dependency-name: "@swc/plugin-transform-imports" directory: "/superset-frontend/" schedule: interval: "daily" diff --git a/.github/workflows/check_db_migration_confict.yml b/.github/workflows/check_db_migration_confict.yml index b0da6094f0e..e5db0dd5554 100644 --- a/.github/workflows/check_db_migration_confict.yml +++ b/.github/workflows/check_db_migration_confict.yml @@ -69,7 +69,7 @@ jobs: `❗ @${pull.user.login} Your base branch \`${currentBranch}\` has ` + 'also updated `superset/migrations`.\n' + '\n' + - '**Please consider rebasing your branch and [resolving potential db migration conflicts](https://github.com/apache/superset/blob/master/CONTRIBUTING.md#merging-db-migrations).**', + '**Please consider rebasing your branch and [resolving potential db migration conflicts](https://superset.apache.org/docs/contributing/development#merging-db-migrations).**', }); } } diff --git a/.github/workflows/superset-docs-deploy.yml b/.github/workflows/superset-docs-deploy.yml index a391d2ae5b1..d70edeb2ff9 100644 --- a/.github/workflows/superset-docs-deploy.yml +++ b/.github/workflows/superset-docs-deploy.yml @@ -1,6 +1,13 @@ name: Docs Deployment on: + # Deploy after integration tests complete on master + workflow_run: + workflows: ["Python-Integration"] + types: [completed] + branches: [master] + + # Also allow manual trigger and direct pushes to docs push: paths: - "docs/**" @@ -30,9 +37,10 @@ jobs: name: Build & Deploy runs-on: ubuntu-24.04 steps: - - name: "Checkout ${{ github.ref }} ( ${{ github.sha }} )" + - name: "Checkout ${{ github.event.workflow_run.head_sha || github.sha }}" uses: actions/checkout@v6 with: + ref: ${{ github.event.workflow_run.head_sha || github.sha }} persist-credentials: false submodules: recursive - name: Set up Node.js @@ -58,6 +66,35 @@ jobs: working-directory: docs run: | yarn install --check-cache + - name: Download database diagnostics (if triggered by integration tests) + if: github.event_name == 'workflow_run' && github.event.workflow_run.conclusion == 'success' + uses: dawidd6/action-download-artifact@v12 + continue-on-error: true + with: + workflow: superset-python-integrationtest.yml + run_id: ${{ github.event.workflow_run.id }} + name: database-diagnostics + path: docs/src/data/ + - name: Try to download latest diagnostics (for push/dispatch triggers) + if: github.event_name != 'workflow_run' + uses: dawidd6/action-download-artifact@v12 + continue-on-error: true + with: + workflow: superset-python-integrationtest.yml + name: database-diagnostics + path: docs/src/data/ + branch: master + search_artifacts: true + if_no_artifact_found: warn + - name: Use diagnostics artifact if available + working-directory: docs + run: | + if [ -f "src/data/databases-diagnostics.json" ]; then + echo "Using fresh diagnostics from integration tests" + mv src/data/databases-diagnostics.json src/data/databases.json + else + echo "Using committed databases.json (no artifact found)" + fi - name: yarn build working-directory: docs run: | @@ -71,5 +108,5 @@ jobs: destination-github-username: "apache" destination-repository-name: "superset-site" target-branch: "asf-site" - commit-message: "deploying docs: ${{ github.event.head_commit.message }} (apache/superset@${{ github.sha }})" + commit-message: "deploying docs: ${{ github.event.head_commit.message || 'triggered by integration tests' }} (apache/superset@${{ github.event.workflow_run.head_sha || github.sha }})" user-email: dev@superset.apache.org diff --git a/.github/workflows/superset-docs-verify.yml b/.github/workflows/superset-docs-verify.yml index 968b7cedb68..c67e106bf5e 100644 --- a/.github/workflows/superset-docs-verify.yml +++ b/.github/workflows/superset-docs-verify.yml @@ -4,17 +4,23 @@ on: pull_request: paths: - "docs/**" + - "superset/db_engine_specs/**" - ".github/workflows/superset-docs-verify.yml" types: [synchronize, opened, reopened, ready_for_review] + workflow_run: + workflows: ["Python-Integration"] + types: [completed] # cancel previous workflow jobs for PRs concurrency: - group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.run_id }} + group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.event.workflow_run.head_sha || github.run_id }} cancel-in-progress: true jobs: linkinator: # See docs here: https://github.com/marketplace/actions/linkinator + # Only run on pull_request, not workflow_run + if: github.event_name == 'pull_request' name: Link Checking runs-on: ubuntu-latest steps: @@ -50,8 +56,11 @@ jobs: https://timbr.ai/, https://opensource.org/license/apache-2-0, https://www.plaidcloud.com/ - build-deploy: - name: Build & Deploy + + build-on-pr: + # Build docs when PR changes docs/** (uses committed databases.json) + if: github.event_name == 'pull_request' + name: Build (PR trigger) runs-on: ubuntu-24.04 defaults: run: @@ -75,3 +84,50 @@ jobs: - name: yarn build run: | yarn build + + build-after-tests: + # Build docs after integration tests complete (uses fresh diagnostics) + # Only runs if integration tests succeeded + if: > + github.event_name == 'workflow_run' && + github.event.workflow_run.conclusion == 'success' + name: Build (after integration tests) + runs-on: ubuntu-24.04 + defaults: + run: + working-directory: docs + steps: + - name: "Checkout PR head: ${{ github.event.workflow_run.head_sha }}" + uses: actions/checkout@v6 + with: + ref: ${{ github.event.workflow_run.head_sha }} + persist-credentials: false + submodules: recursive + - name: Set up Node.js + uses: actions/setup-node@v6 + with: + node-version-file: './docs/.nvmrc' + - name: yarn install + run: | + yarn install --check-cache + - name: Download database diagnostics from integration tests + uses: dawidd6/action-download-artifact@v12 + with: + workflow: superset-python-integrationtest.yml + run_id: ${{ github.event.workflow_run.id }} + name: database-diagnostics + path: docs/src/data/ + - name: Use fresh diagnostics + run: | + if [ -f "src/data/databases-diagnostics.json" ]; then + echo "Using fresh diagnostics from integration tests" + mv src/data/databases-diagnostics.json src/data/databases.json + else + echo "Warning: No diagnostics artifact found, using committed data" + fi + - name: yarn typecheck + run: | + yarn typecheck + - name: yarn build + run: | + yarn build diff --git a/.github/workflows/superset-python-integrationtest.yml b/.github/workflows/superset-python-integrationtest.yml index 5ccb2d3bf85..d8e73d066ae 100644 --- a/.github/workflows/superset-python-integrationtest.yml +++ b/.github/workflows/superset-python-integrationtest.yml @@ -73,6 +73,36 @@ jobs: flags: python,mysql token: ${{ secrets.CODECOV_TOKEN }} verbose: true + - name: Generate database diagnostics for docs + if: steps.check.outputs.python + env: + SUPERSET_CONFIG: tests.integration_tests.superset_test_config + SUPERSET__SQLALCHEMY_DATABASE_URI: | + mysql+mysqldb://superset:superset@127.0.0.1:13306/superset?charset=utf8mb4&binary_prefix=true + run: | + python -c " + import json + from superset.app import create_app + from superset.db_engine_specs.lib import generate_yaml_docs + app = create_app() + with app.app_context(): + docs = generate_yaml_docs() + # Wrap in the expected format + output = { + 'generated': '$(date -Iseconds)', + 'databases': docs + } + with open('databases-diagnostics.json', 'w') as f: + json.dump(output, f, indent=2, default=str) + print(f'Generated diagnostics for {len(docs)} databases') + " + - name: Upload database diagnostics artifact + if: steps.check.outputs.python + uses: actions/upload-artifact@v6 + with: + name: database-diagnostics + path: databases-diagnostics.json + retention-days: 7 test-postgres: runs-on: ubuntu-24.04 strategy: diff --git a/.gitignore b/.gitignore index f90a24e17f9..f86395f0a5c 100644 --- a/.gitignore +++ b/.gitignore @@ -61,6 +61,7 @@ tmp rat-results.txt superset/app/ superset-websocket/config.json +.direnv # Node.js, webpack artifacts, storybook *.entry.js @@ -72,10 +73,6 @@ superset/static/assets/* superset/static/uploads/* !superset/static/uploads/.gitkeep superset/static/version_info.json -superset-frontend/**/esm/* -superset-frontend/**/lib/* -superset-frontend/**/storybook-static/* -superset-frontend/migration-storybook.log yarn-error.log *.map *.min.js @@ -139,3 +136,4 @@ PROJECT.md .env.local oxc-custom-build/ *.code-workspace +*.duckdb diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml index 0ca94fca54f..825304db836 100644 --- a/.pre-commit-config.yaml +++ b/.pre-commit-config.yaml @@ -49,7 +49,7 @@ repos: hooks: - id: check-docstring-first - id: check-added-large-files - exclude: ^.*\.(geojson)$|^docs/static/img/screenshots/.*|^superset-frontend/CHANGELOG\.md$ + exclude: ^.*\.(geojson)$|^docs/static/img/screenshots/.*|^superset-frontend/CHANGELOG\.md$|^superset/examples/.*/data\.parquet$ - id: check-yaml exclude: ^helm/superset/templates/ - id: debug-statements @@ -142,3 +142,18 @@ repos: else echo "No Python files to lint." fi + - id: db-engine-spec-metadata + name: database engine spec metadata validation + entry: python superset/db_engine_specs/lint_metadata.py --strict + language: system + files: ^superset/db_engine_specs/.*\.py$ + exclude: ^superset/db_engine_specs/(base|lib|lint_metadata|__init__)\.py$ + pass_filenames: false + - repo: local + hooks: + - id: feature-flags-sync + name: feature flags documentation sync + entry: bash -c 'python scripts/extract_feature_flags.py > docs/static/feature-flags.json.tmp && if ! diff -q docs/static/feature-flags.json docs/static/feature-flags.json.tmp > /dev/null 2>&1; then mv docs/static/feature-flags.json.tmp docs/static/feature-flags.json && echo "Updated docs/static/feature-flags.json" && exit 1; else rm docs/static/feature-flags.json.tmp; fi' + language: system + files: ^superset/config\.py$ + pass_filenames: false diff --git a/.rat-excludes b/.rat-excludes index afe8329057c..228cc2a39b0 100644 --- a/.rat-excludes +++ b/.rat-excludes @@ -71,10 +71,14 @@ temporary_superset_ui/* google-big-query.svg google-sheets.svg ibm-db2.svg +netlify.png postgresql.svg snowflake.svg ydb.svg loading.svg +apache-solr.svg +azure.svg +superset.svg # docs third-party logos, i.e. docs/static/img/logos/* logos/* diff --git a/AGENTS.md b/AGENTS.md index 1b676b0157f..6e1efb4a1bd 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -2,6 +2,27 @@ Apache Superset is a data visualization platform with Flask/Python backend and React/TypeScript frontend. +## ⚠️ CRITICAL: Always Run Pre-commit Before Pushing + +**ALWAYS run `pre-commit run --all-files` before pushing commits.** CI will fail if pre-commit checks don't pass. This is non-negotiable. + +```bash +# Stage your changes first +git add . + +# Run pre-commit on all files +pre-commit run --all-files + +# If there are auto-fixes, stage them and commit +git add . +git commit --amend # or new commit +``` + +Common pre-commit failures: +- **Formatting** - black, prettier, eslint will auto-fix +- **Type errors** - mypy failures need manual fixes +- **Linting** - ruff, pylint issues need manual fixes + ## ⚠️ CRITICAL: Ongoing Refactors (What NOT to Do) **These migrations are actively happening - avoid deprecated patterns:** diff --git a/Dockerfile b/Dockerfile index e989ecba37d..f441e613f3b 100644 --- a/Dockerfile +++ b/Dockerfile @@ -26,9 +26,6 @@ ARG BUILDPLATFORM=${BUILDPLATFORM:-amd64} # Include translations in the final build ARG BUILD_TRANSLATIONS="false" -# Build arg to pre-populate examples DuckDB file -ARG LOAD_EXAMPLES_DUCKDB="false" - ###################################################################### # superset-node-ci used as a base for building frontend assets and CI ###################################################################### @@ -146,9 +143,6 @@ RUN if [ "${BUILD_TRANSLATIONS}" = "true" ]; then \ ###################################################################### FROM python-base AS python-common -# Re-declare build arg to receive it in this stage -ARG LOAD_EXAMPLES_DUCKDB - ENV SUPERSET_HOME="/app/superset_home" \ HOME="/app/superset_home" \ SUPERSET_ENV="production" \ @@ -202,17 +196,9 @@ RUN /app/docker/apt-install.sh \ libecpg-dev \ libldap2-dev -# Pre-load examples DuckDB file if requested -RUN if [ "$LOAD_EXAMPLES_DUCKDB" = "true" ]; then \ - mkdir -p /app/data && \ - echo "Downloading pre-built examples.duckdb..." && \ - curl -L -o /app/data/examples.duckdb \ - "https://raw.githubusercontent.com/apache-superset/examples-data/master/examples.duckdb" && \ - chown -R superset:superset /app/data; \ - else \ - mkdir -p /app/data && \ - chown -R superset:superset /app/data; \ - fi +# Create data directory for DuckDB examples database +# The database file will be created at runtime when examples are loaded from Parquet files +RUN mkdir -p /app/data && chown -R superset:superset /app/data # Copy compiled things from previous stages COPY --from=superset-node /app/superset/static/assets superset/static/assets diff --git a/INSTALL.md b/INSTALL.md index afe091241f8..d49e17bddd5 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -16,8 +16,20 @@ KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. --> -# INSTALL / BUILD instructions for Apache Superset +# Installing Apache Superset -At this time, the docker file at RELEASING/Dockerfile.from_local_tarball -constitutes the recipe on how to get to a working release from a source -release tarball. +For comprehensive installation instructions, please see the Apache Superset documentation: + +**[📚 Installation Guide →](https://superset.apache.org/docs/installation/installation-methods)** + +The documentation covers: +- [Docker Compose](https://superset.apache.org/docs/installation/docker-compose) (recommended for development) +- [Kubernetes / Helm](https://superset.apache.org/docs/installation/kubernetes) +- [PyPI](https://superset.apache.org/docs/installation/pypi) +- [Docker Builds](https://superset.apache.org/docs/installation/docker-builds) +- [Architecture Overview](https://superset.apache.org/docs/installation/architecture) + +## Building from Source + +For building from a source release tarball, see the Dockerfile at: +`RELEASING/Dockerfile.from_local_tarball` diff --git a/LINTING_ARCHITECTURE.md b/LINTING_ARCHITECTURE.md deleted file mode 100644 index 274f0c24674..00000000000 --- a/LINTING_ARCHITECTURE.md +++ /dev/null @@ -1,121 +0,0 @@ - - -# Superset Frontend Linting Architecture - -## Overview -We use a hybrid linting approach combining OXC (fast, standard rules) with custom AST-based checks for Superset-specific patterns. - -## Components - -### 1. Primary Linter: OXC -- **What**: Oxidation Compiler's linter (oxlint) -- **Handles**: 95% of linting rules (standard ESLint rules, TypeScript, React, etc.) -- **Speed**: ~50-100x faster than ESLint -- **Config**: `oxlint.json` - -### 2. Custom Rule Checker -- **What**: Node.js AST-based script -- **Handles**: Superset-specific rules: - - No literal colors (use theme) - - No FontAwesome icons (use Icons component) - - No template vars in i18n -- **Speed**: Fast enough for pre-commit -- **Script**: `scripts/check-custom-rules.js` - -## Developer Workflow - -### Local Development -```bash -# Fast linting (OXC only) -npm run lint - -# Full linting (OXC + custom rules) -npm run lint:full - -# Auto-fix what's possible -npm run lint-fix -``` - -### Pre-commit -1. OXC runs first (via `scripts/oxlint.sh`) -2. Custom rules check runs second (lightweight, AST-based) -3. Both must pass for commit to succeed - -### CI Pipeline -```yaml -- name: Lint with OXC - run: npm run lint - -- name: Check custom rules - run: npm run check:custom-rules -``` - -## Why This Architecture? - -### ✅ Pros -1. **No binary distribution issues** - ASF compatible -2. **Fast performance** - OXC for bulk, lightweight script for custom -3. **Maintainable** - Custom rules in JavaScript, not Rust -4. **Flexible** - Can evolve as OXC adds plugin support -5. **Cacheable** - Both OXC and Node.js are standard tools - -### ❌ Cons -1. **Two tools** - Slightly more complex than single linter -2. **Duplicate parsing** - Files parsed twice (once by each tool) - -### 🔄 Migration Path -When OXC supports JavaScript plugins: -1. Convert `check-custom-rules.js` to OXC plugin format -2. Consolidate back to single tool -3. Keep same rules and developer experience - -## Implementation Checklist - -- [x] OXC for standard linting -- [x] Pre-commit integration -- [ ] Custom rules script -- [ ] Combine in npm scripts -- [ ] Update CI pipeline -- [ ] Developer documentation - -## Performance Targets - -| Operation | Target Time | Current | -|-----------|------------|---------| -| Pre-commit (changed files) | <2s | ✅ 1.5s | -| Full lint (all files) | <10s | ✅ 8s | -| Custom rules check | <5s | 🔄 TBD | - -## Caching Strategy - -### Local Development -- OXC: Built-in incremental checking -- Custom rules: Use file hash cache (similar to pytest cache) - -### CI -- Cache `node_modules` (includes oxlint binary) -- Cache custom rules results by commit hash -- Skip unchanged files using git diff - -## Future Improvements - -1. **When OXC adds plugin support**: Migrate custom rules to OXC plugins -2. **Consider Biome**: Another Rust-based linter with plugin support -3. **AST sharing**: Investigate sharing AST between tools to avoid double parsing diff --git a/README.md b/README.md index f7d59ee6915..d12a7d066cb 100644 --- a/README.md +++ b/README.md @@ -101,51 +101,81 @@ Superset provides: ## Supported Databases -Superset can query data from any SQL-speaking datastore or data engine (Presto, Trino, Athena, [and more](https://superset.apache.org/docs/configuration/databases)) that has a Python DB-API driver and a SQLAlchemy dialect. +Superset can query data from any SQL-speaking datastore or data engine (Presto, Trino, Athena, [and more](https://superset.apache.org/docs/databases)) that has a Python DB-API driver and a SQLAlchemy dialect. Here are some of the major database solutions that are supported: +

- redshift - google-bigquery - snowflake - trino - presto - databricks - druid - firebolt - timescale - postgresql - mysql - mssql-server - db2 - sqlite - sybase - mariadb - vertica - oracle - firebird - greenplum - clickhouse - exasol - monet-db - apache-kylin - hologres - netezza - pinot - teradata - yugabyte - databend - starrocks - doris - oceanbase - sap-hana - denodo - ydb - TDengine + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ -**A more comprehensive list of supported databases** along with the configuration instructions can be found [here](https://superset.apache.org/docs/configuration/databases). +**A more comprehensive list of supported databases** along with the configuration instructions can be found [here](https://superset.apache.org/docs/databases). Want to add support for your datastore or data engine? Read more [here](https://superset.apache.org/docs/frequently-asked-questions#does-superset-work-with-insert-database-engine-here) about the technical requirements. @@ -165,14 +195,14 @@ Try out Superset's [quickstart](https://superset.apache.org/docs/quickstart/) gu ## Contributor Guide Interested in contributing? Check out our -[CONTRIBUTING.md](https://github.com/apache/superset/blob/master/CONTRIBUTING.md) +[Developer Portal](https://superset.apache.org/developer_portal/) to find resources around contributing along with a detailed guide on how to set up a development environment. ## Resources - [Superset "In the Wild"](https://superset.apache.org/inTheWild) - see who's using Superset, and [add your organization](https://github.com/apache/superset/edit/master/RESOURCES/INTHEWILD.yaml) to the list! -- [Feature Flags](https://github.com/apache/superset/blob/master/RESOURCES/FEATURE_FLAGS.md) - the status of Superset's Feature Flags. +- [Feature Flags](https://superset.apache.org/docs/configuration/feature-flags) - the status of Superset's Feature Flags. - [Standard Roles](https://github.com/apache/superset/blob/master/RESOURCES/STANDARD_ROLES.md) - How RBAC permissions map to roles. - [Superset Wiki](https://github.com/apache/superset/wiki) - Tons of additional community resources: best practices, community content and other information. - [Superset SIPs](https://github.com/orgs/apache/projects/170) - The status of Superset's SIPs (Superset Improvement Proposals) for both consensus and implementation status. diff --git a/RELEASING/release-notes-1-0/README.md b/RELEASING/release-notes-1-0/README.md index 6379bf099ca..8bb50cc5c04 100644 --- a/RELEASING/release-notes-1-0/README.md +++ b/RELEASING/release-notes-1-0/README.md @@ -92,7 +92,7 @@ Some of the new features in this release are disabled by default. Each has a fea | Feature | Feature Flag | Dependencies | Documentation | --- | --- | --- | --- | -| Global Async Queries | `GLOBAL_ASYNC_QUERIES: True` | Redis 5.0+, celery workers configured and running | [Extra documentation](https://github.com/apache/superset/blob/master/CONTRIBUTING.md#async-chart-queries ) +| Global Async Queries | `GLOBAL_ASYNC_QUERIES: True` | Redis 5.0+, celery workers configured and running | [Extra documentation](https://superset.apache.org/docs/contributing/misc#async-chart-queries) | Dashboard Native Filters | `DASHBOARD_NATIVE_FILTERS: True` | | | Alerts & Reporting | `ALERT_REPORTS: True` | [Celery workers configured & celery beat process](https://superset.apache.org/docs/installation/async-queries-celery) | | Homescreen Thumbnails | `THUMBNAILS: TRUE, THUMBNAIL_CACHE_CONFIG: CacheConfig = { "CACHE_TYPE": "null", "CACHE_NO_NULL_WARNING": True}`| selenium, pillow 7, celery | diff --git a/RESOURCES/FEATURE_FLAGS.md b/RESOURCES/FEATURE_FLAGS.md deleted file mode 100644 index d4b47d0b6bc..00000000000 --- a/RESOURCES/FEATURE_FLAGS.md +++ /dev/null @@ -1,103 +0,0 @@ - - -# Superset Feature Flags - -This is a list of the current Superset optional features. See config.py for default values. These features can be turned on/off by setting your preferred values in superset_config.py to True/False respectively - -## In Development - -These features are considered **unfinished** and should only be used on development environments. - -[//]: # "PLEASE KEEP THE LIST SORTED ALPHABETICALLY" - -- ALERT_REPORT_TABS -- DATE_RANGE_TIMESHIFTS_ENABLED -- ENABLE_ADVANCED_DATA_TYPES -- PRESTO_EXPAND_DATA -- SHARE_QUERIES_VIA_KV_STORE -- TAGGING_SYSTEM -- CHART_PLUGINS_EXPERIMENTAL - -## In Testing - -These features are **finished** but currently being tested. They are usable, but may still contain some bugs. - -[//]: # "PLEASE KEEP THE LIST SORTED ALPHABETICALLY" - -- ALERT_REPORTS: [(docs)](https://superset.apache.org/docs/configuration/alerts-reports) -- ALLOW_FULL_CSV_EXPORT -- CACHE_IMPERSONATION -- CONFIRM_DASHBOARD_DIFF -- DYNAMIC_PLUGINS -- DATE_FORMAT_IN_EMAIL_SUBJECT: [(docs)](https://superset.apache.org/docs/configuration/alerts-reports#commons) -- ENABLE_SUPERSET_META_DB: [(docs)](https://superset.apache.org/docs/configuration/databases/#querying-across-databases) -- ESTIMATE_QUERY_COST -- GLOBAL_ASYNC_QUERIES [(docs)](https://github.com/apache/superset/blob/master/CONTRIBUTING.md#async-chart-queries) -- IMPERSONATE_WITH_EMAIL_PREFIX -- PLAYWRIGHT_REPORTS_AND_THUMBNAILS -- RLS_IN_SQLLAB -- SSH_TUNNELING [(docs)](https://superset.apache.org/docs/configuration/setup-ssh-tunneling) -- USE_ANALAGOUS_COLORS - -## Stable - -These features flags are **safe for production**. They have been tested and will be supported for the at least the current major version cycle. - -[//]: # "PLEASE KEEP THESE LISTS SORTED ALPHABETICALLY" - -### Flags on the path to feature launch and flag deprecation/removal - -- DASHBOARD_VIRTUALIZATION - -### Flags retained for runtime configuration - -Currently some of our feature flags act as dynamic configurations that can change -on the fly. This acts in contradiction with the typical ephemeral feature flag use case, -where the flag is used to mature a feature, and eventually deprecated once the feature is -solid. Eventually we'll likely refactor these under a more formal "dynamic configurations" managed -independently. This new framework will also allow for non-boolean configurations. - -- ALERTS_ATTACH_REPORTS -- ALLOW_ADHOC_SUBQUERY -- DASHBOARD_RBAC [(docs)](https://superset.apache.org/docs/using-superset/creating-your-first-dashboard#manage-access-to-dashboards) -- DATAPANEL_CLOSED_BY_DEFAULT -- DRILL_BY -- DRUID_JOINS -- EMBEDDABLE_CHARTS -- EMBEDDED_SUPERSET -- ENABLE_TEMPLATE_PROCESSING -- ESCAPE_MARKDOWN_HTML -- LISTVIEWS_DEFAULT_CARD_VIEW -- SCHEDULED_QUERIES [(docs)](https://superset.apache.org/docs/configuration/alerts-reports) -- SLACK_ENABLE_AVATARS (see `superset/config.py` for more information) -- SQLLAB_BACKEND_PERSISTENCE -- SQL_VALIDATORS_BY_ENGINE [(docs)](https://superset.apache.org/docs/configuration/sql-templating) -- THUMBNAILS [(docs)](https://superset.apache.org/docs/configuration/cache) - -## Deprecated Flags - -These features flags currently default to True and **will be removed in a future major release**. For this current release you can turn them off by setting your config to False, but it is advised to remove or set these flags in your local configuration to **True** so that you do not experience any unexpected changes in a future release. - -[//]: # "PLEASE KEEP THE LIST SORTED ALPHABETICALLY" - -- AVOID_COLORS_COLLISION -- DRILL_TO_DETAIL -- ENABLE_JAVASCRIPT_CONTROLS -- KV_STORE diff --git a/RESOURCES/INTHEWILD.yaml b/RESOURCES/INTHEWILD.yaml index 0627c0bf488..f68a9029efc 100644 --- a/RESOURCES/INTHEWILD.yaml +++ b/RESOURCES/INTHEWILD.yaml @@ -136,10 +136,6 @@ categories: url: https://www.dropit.shop/ contributors: ["@dropit-dev"] - - name: Fanatics - url: https://www.fanatics.com/ - contributors: ["@coderfender"] - - name: Fordeal url: https://www.fordeal.com contributors: ["@Renkai"] @@ -622,6 +618,20 @@ categories: - name: Stockarea url: https://stockarea.io + Sports: + - name: Club 25 de Agosto (Femenino / Women's Team) + url: https://www.instagram.com/25deagosto.basketfemenino/ + contributors: [ "@lion90" ] + logo: club25deagosto.svg + + - name: Fanatics + url: https://www.fanatics.com/ + contributors: [ "@coderfender" ] + + - name: komoot + url: https://www.komoot.com/ + contributors: [ "@christophlingg" ] + Others: - name: 10Web url: https://10web.io/ @@ -657,10 +667,6 @@ categories: url: https://www.increff.com/ contributors: ["@ishansinghania"] - - name: komoot - url: https://www.komoot.com/ - contributors: ["@christophlingg"] - - name: Let's Roam url: https://www.letsroam.com/ diff --git a/UPDATING.md b/UPDATING.md index 148426d7cf3..89418e4102c 100644 --- a/UPDATING.md +++ b/UPDATING.md @@ -24,6 +24,41 @@ assists people when migrating to a new version. ## Next +### Example Data Loading Improvements + +#### New Directory Structure +Examples are now organized by name with data and configs co-located: +``` +superset/examples/ +├── _shared/ # Shared database & metadata configs +├── birth_names/ # Each example is self-contained +│ ├── data.parquet # Dataset (Parquet format) +│ ├── dataset.yaml # Dataset metadata +│ ├── dashboard.yaml # Dashboard config (optional) +│ └── charts/ # Chart configs (optional) +└── ... +``` + +#### Simplified Parquet-based Loading +- Auto-discovery: create `superset/examples/my_dataset/data.parquet` to add a new example +- Parquet is an Apache project format: compressed (~27% smaller), self-describing schema +- YAML configs define datasets, charts, and dashboards declaratively +- Removed Python-based data generation from individual example files + +#### Test Data Reorganization +- Moved `big_data.py` to `superset/cli/test_loaders.py` - better reflects its purpose as a test utility +- Fixed inverted logic for `--load-test-data` flag (now correctly includes .test.yaml files when flag is set) +- Clarified CLI flags: + - `--force` / `-f`: Force reload even if tables exist + - `--only-metadata` / `-m`: Create table metadata without loading data + - `--load-test-data` / `-t`: Include test dashboards and .test.yaml configs + - `--load-big-data` / `-b`: Generate synthetic stress-test data + +#### Bug Fixes +- Fixed numpy array serialization for PostgreSQL (converts complex types to JSON strings) +- Fixed KeyError for `allow_csv_upload` field in database configs (now optional with default) +- Fixed test data loading logic that was incorrectly filtering files + ### MCP Service The MCP (Model Context Protocol) service enables AI assistants and automation tools to interact programmatically with Superset. @@ -128,6 +163,28 @@ See `superset/mcp_service/PRODUCTION.md` for deployment guides. - [35062](https://github.com/apache/superset/pull/35062): Changed the function signature of `setupExtensions` to `setupCodeOverrides` with options as arguments. ### Breaking Changes +- [37370](https://github.com/apache/superset/pull/37370): The `APP_NAME` configuration variable no longer controls the browser window/tab title or other frontend branding. Application names should now be configured using the theme system with the `brandAppName` token. The `APP_NAME` config is still used for backend contexts (MCP service, logs, etc.) and serves as a fallback if `brandAppName` is not set. + - **Migration:** + ```python + # Before (Superset 5.x) + APP_NAME = "My Custom App" + + # After (Superset 6.x) - Option 1: Use theme system (recommended) + THEME_DEFAULT = { + "token": { + "brandAppName": "My Custom App", # Window titles + "brandLogoAlt": "My Custom App", # Logo alt text + "brandLogoUrl": "/static/assets/images/custom_logo.png" + } + } + + # After (Superset 6.x) - Option 2: Temporary fallback + # Keep APP_NAME for now (will be used as fallback for brandAppName) + APP_NAME = "My Custom App" + # But you should migrate to THEME_DEFAULT.token.brandAppName + ``` + - **Note:** For dark mode, set the same tokens in `THEME_DARK` configuration. + - [36317](https://github.com/apache/superset/pull/36317): The `CUSTOM_FONT_URLS` configuration option has been removed. Use the new per-theme `fontUrls` token in `THEME_DEFAULT` or database-managed themes instead. - **Before:** ```python @@ -142,7 +199,7 @@ See `superset/mcp_service/PRODUCTION.md` for deployment guides. "fontUrls": [ "https://fonts.example.com/myfont.css", ], - # ... other tokens + # ... other tokens } } ``` diff --git a/docker-compose-light.yml b/docker-compose-light.yml index b06be681af3..09b0c65b0f8 100644 --- a/docker-compose-light.yml +++ b/docker-compose-light.yml @@ -77,7 +77,6 @@ x-common-build: &common-build INCLUDE_CHROMIUM: ${INCLUDE_CHROMIUM:-false} INCLUDE_FIREFOX: ${INCLUDE_FIREFOX:-false} BUILD_TRANSLATIONS: ${BUILD_TRANSLATIONS:-false} - LOAD_EXAMPLES_DUCKDB: ${LOAD_EXAMPLES_DUCKDB:-true} services: db-light: @@ -116,7 +115,6 @@ services: DATABASE_HOST: db-light DATABASE_DB: superset_light POSTGRES_DB: superset_light - SUPERSET__SQLALCHEMY_EXAMPLES_URI: "duckdb:////app/data/examples.duckdb" SUPERSET_CONFIG_PATH: /app/docker/pythonpath_dev/superset_config_docker_light.py GITHUB_HEAD_REF: ${GITHUB_HEAD_REF:-} GITHUB_SHA: ${GITHUB_SHA:-} @@ -139,7 +137,6 @@ services: DATABASE_HOST: db-light DATABASE_DB: superset_light POSTGRES_DB: superset_light - SUPERSET__SQLALCHEMY_EXAMPLES_URI: "duckdb:////app/data/examples.duckdb" SUPERSET_CONFIG_PATH: /app/docker/pythonpath_dev/superset_config_docker_light.py healthcheck: disable: true @@ -196,7 +193,6 @@ services: DATABASE_DB: test POSTGRES_DB: test SUPERSET__SQLALCHEMY_DATABASE_URI: postgresql+psycopg2://superset:superset@db-light:5432/test - SUPERSET__SQLALCHEMY_EXAMPLES_URI: "duckdb:////app/data/examples.duckdb" SUPERSET_CONFIG: superset_test_config_light PYTHONPATH: /app/pythonpath:/app/docker/pythonpath_dev:/app diff --git a/docker-compose.yml b/docker-compose.yml index 5930951776f..f133653f396 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -44,7 +44,6 @@ x-common-build: &common-build INCLUDE_CHROMIUM: ${INCLUDE_CHROMIUM:-false} INCLUDE_FIREFOX: ${INCLUDE_FIREFOX:-false} BUILD_TRANSLATIONS: ${BUILD_TRANSLATIONS:-false} - LOAD_EXAMPLES_DUCKDB: ${LOAD_EXAMPLES_DUCKDB:-true} services: nginx: @@ -106,8 +105,6 @@ services: superset-init: condition: service_completed_successfully volumes: *superset-volumes - environment: - SUPERSET__SQLALCHEMY_EXAMPLES_URI: "duckdb:////app/data/examples.duckdb" superset-websocket: build: ./superset-websocket @@ -157,8 +154,6 @@ services: condition: service_started user: *superset-user volumes: *superset-volumes - environment: - SUPERSET__SQLALCHEMY_EXAMPLES_URI: "duckdb:////app/data/examples.duckdb" healthcheck: disable: true diff --git a/docs/.gitignore b/docs/.gitignore index 6880a0863d9..90904a9ff46 100644 --- a/docs/.gitignore +++ b/docs/.gitignore @@ -26,3 +26,10 @@ docs/intro.md # Generated badge images (downloaded at build time by remark-localize-badges plugin) static/badges/ + +# Generated database documentation MDX files (regenerated at build time) +# Source of truth is in superset/db_engine_specs/*.py metadata attributes +docs/databases/ + +# Note: src/data/databases.json is COMMITTED (not ignored) to preserve feature diagnostics +# that require Flask context to generate. Update it locally with: npm run gen-db-docs diff --git a/docs/DOCS_CLAUDE.md b/docs/DOCS_CLAUDE.md index 42fd0ad71a9..039b701ba1d 100644 --- a/docs/DOCS_CLAUDE.md +++ b/docs/DOCS_CLAUDE.md @@ -416,7 +416,7 @@ If versions don't appear in dropdown: - [Docusaurus Documentation](https://docusaurus.io/docs) - [MDX Documentation](https://mdxjs.com/) -- [Superset Contributing Guide](../CONTRIBUTING.md) +- [Superset Developer Portal](https://superset.apache.org/developer_portal/) - [Main Superset Documentation](https://superset.apache.org/docs/intro) ## 📖 Real Examples and Patterns diff --git a/docs/README.md b/docs/README.md index 8af3ea90da5..dbf7a51238b 100644 --- a/docs/README.md +++ b/docs/README.md @@ -18,9 +18,9 @@ under the License. --> This is the public documentation site for Superset, built using -[Docusaurus 3](https://docusaurus.io/). See -[CONTRIBUTING.md](../CONTRIBUTING.md#documentation) for documentation on -contributing to documentation. +[Docusaurus 3](https://docusaurus.io/). See the +[Developer Portal](https://superset.apache.org/developer_portal/contributing/development-setup#documentation) +for documentation on contributing to documentation. ## Version Management diff --git a/docs/developer_portal/contributing/development-setup.md b/docs/developer_portal/contributing/development-setup.md index cd173d24a49..fdddbf1af55 100644 --- a/docs/developer_portal/contributing/development-setup.md +++ b/docs/developer_portal/contributing/development-setup.md @@ -653,7 +653,7 @@ export enum FeatureFlag { those specified under FEATURE_FLAGS in `superset_config.py`. For example, `DEFAULT_FEATURE_FLAGS = { 'FOO': True, 'BAR': False }` in `superset/config.py` and `FEATURE_FLAGS = { 'BAR': True, 'BAZ': True }` in `superset_config.py` will result in combined feature flags of `{ 'FOO': True, 'BAR': True, 'BAZ': True }`. -The current status of the usability of each flag (stable vs testing, etc) can be found in `RESOURCES/FEATURE_FLAGS.md`. +The current status of the usability of each flag (stable vs testing, etc) can be found in the [Feature Flags](/docs/configuration/feature-flags) documentation. ## Git Hooks diff --git a/docs/developer_portal/contributing/howtos.md b/docs/developer_portal/contributing/howtos.md index c353944d7e1..8468b8ca205 100644 --- a/docs/developer_portal/contributing/howtos.md +++ b/docs/developer_portal/contributing/howtos.md @@ -342,26 +342,79 @@ ruff check --fix . Pre-commit hooks run automatically on `git commit` if installed. -### TypeScript +### TypeScript / JavaScript -We use ESLint and Prettier for TypeScript: +We use a hybrid linting approach combining OXC (Oxidation Compiler) for standard rules and a custom AST-based checker for Superset-specific patterns. + +#### Quick Commands ```bash cd superset-frontend -# Run eslint checks +# Run both OXC and custom rules +npm run lint:full + +# Run OXC linter only (faster for most checks) npm run lint +# Fix auto-fixable issues with OXC +npm run lint-fix + +# Run custom rules checker only +npm run check:custom-rules + # Run tsc (typescript) checks npm run type -# Fix lint issues -npm run lint-fix - # Format with Prettier npm run prettier ``` +#### Architecture + +The linting system consists of two components: + +1. **OXC Linter** (`oxlint`) - A Rust-based linter that's 50-100x faster than ESLint + - Handles all standard JavaScript/TypeScript rules + - Configured via `oxlint.json` + - Runs via `npm run lint` or `npm run lint-fix` + +2. **Custom Rules Checker** - A Node.js AST-based checker for Superset-specific patterns + - Enforces no literal colors (use theme colors) + - Prevents FontAwesome usage (use @superset-ui/core Icons) + - Validates i18n template usage (no template variables) + - Runs via `npm run check:custom-rules` + +#### Why This Approach? + +- **50-100x faster linting** compared to ESLint for standard rules via OXC +- **Apache-compatible** - No custom binaries, ASF-friendly +- **Maintainable** - Custom rules in JavaScript, not Rust +- **Flexible** - Can evolve as OXC adds plugin support + +#### Troubleshooting + +**"Plugin 'basic-custom-plugin' not found" Error** + +Ensure you're using the explicit config: +```bash +npx oxlint --config oxlint.json +``` + +**Custom Rules Not Running** + +Verify the AST parsing dependencies are installed: +```bash +npm ls @babel/parser @babel/traverse glob +``` + +#### Adding New Custom Rules + +1. Edit `scripts/check-custom-rules.js` +2. Add a new check function following the AST visitor pattern +3. Call the function in `processFile()` +4. Test with `npm run check:custom-rules` + ## GitHub Ephemeral Environments For every PR, an ephemeral environment is automatically deployed for testing. diff --git a/docs/developer_portal/guidelines/frontend-style-guidelines.md b/docs/developer_portal/guidelines/frontend-style-guidelines.md index b27cbafb5e2..03ab3cfc619 100644 --- a/docs/developer_portal/guidelines/frontend-style-guidelines.md +++ b/docs/developer_portal/guidelines/frontend-style-guidelines.md @@ -43,8 +43,9 @@ This is a list of statements that describe how we do frontend development in Sup - We organize our repo so similar files live near each other, and tests are co-located with the files they test. - See: [SIP-61](https://github.com/apache/superset/issues/12098) - We prefer small, easily testable files and components. -- We use ESLint and Prettier to automatically fix lint errors and format the code. +- We use OXC (oxlint) and Prettier to automatically fix lint errors and format the code. - We do not debate code formatting style in PRs, instead relying on automated tooling to enforce it. - If there's not a linting rule, we don't have a rule! + - See: [Linting How-Tos](../contributing/howtos#typescript--javascript) - We use [React Storybook](https://storybook.js.org/) and [Applitools](https://applitools.com/) to help preview/test and stabilize our components - A public Storybook with components from the `master` branch is available [here](https://apache-superset.github.io/superset-ui/?path=/story/*) diff --git a/docs/developer_portal/index.md b/docs/developer_portal/index.md index fce0b76456a..fe567fcc5a9 100644 --- a/docs/developer_portal/index.md +++ b/docs/developer_portal/index.md @@ -86,7 +86,6 @@ Everything you need to contribute to the Apache Superset project. This section i - **[Configuration Guide](https://superset.apache.org/docs/configuration/configuring-superset)** - Setup and configuration ### Important Files -- **[CONTRIBUTING.md](https://github.com/apache/superset/blob/master/CONTRIBUTING.md)** - Contribution guidelines - **[CLAUDE.md](https://github.com/apache/superset/blob/master/CLAUDE.md)** - LLM development guide - **[UPDATING.md](https://github.com/apache/superset/blob/master/UPDATING.md)** - Breaking changes log diff --git a/docs/developer_portal/testing/e2e-testing.md b/docs/developer_portal/testing/e2e-testing.md index ad0fdd41180..a4536123767 100644 --- a/docs/developer_portal/testing/e2e-testing.md +++ b/docs/developer_portal/testing/e2e-testing.md @@ -24,57 +24,204 @@ under the License. # End-to-End Testing -🚧 **Coming Soon** 🚧 +Apache Superset uses Playwright for end-to-end testing, migrating from the legacy Cypress tests. -Guide for writing and running end-to-end tests using Playwright and Cypress. - -## Topics to be covered: +## Running Tests ### Playwright (Recommended) -- Setting up Playwright environment -- Writing reliable E2E tests -- Page Object Model pattern -- Handling async operations -- Cross-browser testing -- Visual regression testing -- Debugging with Playwright Inspector -- CI/CD integration -### Cypress (Deprecated) -- Legacy Cypress test maintenance -- Migration to Playwright -- Running existing Cypress tests - -## Quick Commands - -### Playwright ```bash -# Run all Playwright tests -npm run playwright:test +cd superset-frontend -# Run in headed mode (see browser) -npm run playwright:headed +# Run all tests +npm run playwright:test +# or: npx playwright test # Run specific test file npx playwright test tests/auth/login.spec.ts -# Debug specific test -npm run playwright:debug tests/auth/login.spec.ts - -# Open Playwright UI +# Run with UI mode for debugging npm run playwright:ui +# or: npx playwright test --ui + +# Run in headed mode (see browser) +npm run playwright:headed +# or: npx playwright test --headed + +# Debug specific test file +npm run playwright:debug tests/auth/login.spec.ts +# or: npx playwright test --debug tests/auth/login.spec.ts ``` ### Cypress (Deprecated) -```bash -# Run Cypress tests -cd superset-frontend/cypress-base -npm run cypress-run-chrome -# Open Cypress UI -npm run cypress-debug +Cypress tests are being migrated to Playwright. For legacy tests: + +```bash +cd superset-frontend/cypress-base +npm run cypress-run-chrome # Headless +npm run cypress-debug # Interactive UI ``` ---- +## Project Architecture -*This documentation is under active development. Check back soon for updates!* +``` +superset-frontend/playwright/ +├── components/core/ # Reusable UI components +├── pages/ # Page Object Models +├── tests/ # Test files organized by feature +├── utils/ # Shared constants and utilities +└── playwright.config.ts +``` + +## Design Principles + +We follow **YAGNI** (You Aren't Gonna Need It), **DRY** (Don't Repeat Yourself), and **KISS** (Keep It Simple, Stupid) principles: + +- Build only what's needed now +- Reuse existing patterns and components +- Keep solutions simple and maintainable + +## Page Object Pattern + +Each page object encapsulates: + +- **Actions**: What you can do on the page +- **Queries**: Information you can get from the page +- **Selectors**: Centralized in private static SELECTORS constant +- **NO Assertions**: Keep assertions in test files + +**Example Page Object:** + +```typescript +export class AuthPage { + // Selectors centralized in the page object + private static readonly SELECTORS = { + LOGIN_FORM: '[data-test="login-form"]', + USERNAME_INPUT: '[data-test="username-input"]', + } as const; + + // Actions - what you can do + async loginWithCredentials(username: string, password: string) {} + + // Queries - information you can get + async getCurrentUrl(): Promise {} + + // NO assertions - those belong in tests +} +``` + +**Example Test:** + +```typescript +import { test, expect } from '@playwright/test'; +import { AuthPage } from '../../pages/AuthPage'; +import { LOGIN } from '../../utils/urls'; + +test('should login with correct credentials', async ({ page }) => { + const authPage = new AuthPage(page); + await authPage.goto(); + await authPage.loginWithCredentials('admin', 'general'); + + // Assertions belong in tests, not page objects + expect(await authPage.getCurrentUrl()).not.toContain(LOGIN); +}); +``` + +## Core Components + +Reusable UI interaction classes for common elements (`components/core/`): + +- **Form**: Container with properly scoped child element access +- **Input**: Supports `fill()`, `type()`, and `pressSequentially()` methods +- **Button**: Standard click, hover, focus interactions + +**Usage Example:** + +```typescript +import { Form } from '../components/core'; + +const loginForm = new Form(page, '[data-test="login-form"]'); +const usernameInput = loginForm.getInput('[data-test="username-input"]'); +await usernameInput.fill('admin'); +``` + +## Test Reports + +Playwright generates multiple reports for better visibility: + +```bash +# View interactive HTML report (opens automatically on failure) +npm run playwright:report +# or: npx playwright show-report + +# View test trace for debugging failures +npx playwright show-trace test-results/[test-name]/trace.zip +``` + +### Report Types + +- **List Reporter**: Shows progress and summary table in terminal +- **HTML Report**: Interactive web interface with screenshots, videos, and traces +- **JSON Report**: Machine-readable format in `test-results/results.json` +- **GitHub Actions**: Annotations in CI for failed tests + +### Debugging Failed Tests + +When tests fail, Playwright automatically captures: + +- **Screenshots** at the point of failure +- **Videos** of the entire test run +- **Traces** with timeline and network activity +- **Error context** with detailed debugging information + +All debugging artifacts are available in the HTML report for easy analysis. + +## Configuration + +- **Config**: `playwright.config.ts` - matches Cypress settings +- **Base URL**: `http://localhost:8088` (assumes Superset running) +- **Browsers**: Chrome only for Phase 1 (YAGNI) +- **Retries**: 2 in CI, 0 locally (matches Cypress) + +## Contributing Guidelines + +### Adding New Tests + +1. **Check existing components** before creating new ones +2. **Use page objects** for page interactions +3. **Keep assertions in tests**, not page objects +4. **Follow naming conventions**: `feature.spec.ts` + +### Adding New Components + +1. **Follow YAGNI**: Only build what's immediately needed +2. **Use Locator-based scoping** for proper element isolation +3. **Support both string selectors and Locator objects** via constructor overloads +4. **Add to `components/core/index.ts`** for easy importing + +### Adding New Page Objects + +1. **Centralize selectors** in private static SELECTORS constant +2. **Import shared constants** from `utils/urls.ts` +3. **Actions and queries only** - no assertions +4. **Use existing components** for DOM interactions + +## Migration from Cypress + +When porting Cypress tests: + +1. **Port the logic**, not the implementation +2. **Use page objects** instead of inline selectors +3. **Replace `cy.intercept/cy.wait`** with `page.waitForRequest()` +4. **Use shared constants** from `utils/urls.ts` +5. **Follow the established patterns** shown in `tests/auth/login.spec.ts` + +## Best Practices + +- **Centralize selectors** in page objects +- **Centralize URLs** in `utils/urls.ts` +- **Use meaningful test descriptions** +- **Keep page objects action-focused** +- **Put assertions in tests, not page objects** +- **Follow the existing patterns** for consistency diff --git a/docs/docs/configuration/configuring-superset.mdx b/docs/docs/configuration/configuring-superset.mdx index e7ad43c6d87..e44b533fa99 100644 --- a/docs/docs/configuration/configuring-superset.mdx +++ b/docs/docs/configuration/configuring-superset.mdx @@ -441,7 +441,7 @@ FEATURE_FLAGS = { } ``` -A current list of feature flags can be found in [RESOURCES/FEATURE_FLAGS.md](https://github.com/apache/superset/blob/master/RESOURCES/FEATURE_FLAGS.md). +A current list of feature flags can be found in the [Feature Flags](/docs/configuration/feature-flags) documentation. :::resources - [Blog: Feature Flags in Apache Superset](https://preset.io/blog/feature-flags-in-apache-superset-and-preset/) diff --git a/docs/docs/configuration/databases.mdx b/docs/docs/configuration/databases.mdx deleted file mode 100644 index 98cd9c58a22..00000000000 --- a/docs/docs/configuration/databases.mdx +++ /dev/null @@ -1,2004 +0,0 @@ ---- -title: Connecting to Databases -hide_title: true -sidebar_position: 1 -version: 1 ---- -# Connecting to Databases - -Superset does not ship bundled with connectivity to databases. The main step in connecting -Superset to a database is to **install the proper database driver(s)** -in your environment. - -:::note -You’ll need to install the required packages for the database you want to use as your metadata database -as well as the packages needed to connect to the databases you want to access through Superset. -For information about setting up Superset's metadata database, please refer to -installation documentations ([Docker Compose](/docs/installation/docker-compose), [Kubernetes](/docs/installation/kubernetes)) -::: - -This documentation tries to keep pointer to the different drivers for commonly used database -engine. - -## Installing Database Drivers - -Superset requires a Python [DB-API database driver](https://peps.python.org/pep-0249/) -and a [SQLAlchemy dialect](https://docs.sqlalchemy.org/en/20/dialects/) to be installed for -each database engine you want to connect to. - -You can read more [here](/docs/configuration/databases#installing-drivers-in-docker-images) about how to -install new database drivers into your Superset configuration. - -### Supported Databases and Dependencies - -Some of the recommended packages are shown below. Please refer to -[pyproject.toml](https://github.com/apache/superset/blob/master/pyproject.toml) for the versions that -are compatible with Superset. - -|
Database
| PyPI package | Connection String | -| --------------------------------------------------------- | ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | -| [AWS Athena](/docs/configuration/databases#aws-athena) | `pip install pyathena[pandas]` , `pip install PyAthenaJDBC` | `awsathena+rest://{access_key_id}:{access_key}@athena.{region}.amazonaws.com/{schema}?s3_staging_dir={s3_staging_dir}&...` | -| [AWS DynamoDB](/docs/configuration/databases#aws-dynamodb) | `pip install pydynamodb` | `dynamodb://{access_key_id}:{secret_access_key}@dynamodb.{region_name}.amazonaws.com?connector=superset` | -| [AWS Redshift](/docs/configuration/databases#aws-redshift) | `pip install sqlalchemy-redshift` | `redshift+psycopg2://:@:5439/` | -| [Apache Doris](/docs/configuration/databases#apache-doris) | `pip install pydoris` | `doris://:@:/.` | -| [Apache Drill](/docs/configuration/databases#apache-drill) | `pip install sqlalchemy-drill` | `drill+sadrill://:@:/`, often useful: `?use_ssl=True/False` | -| [Apache Druid](/docs/configuration/databases#apache-druid) | `pip install pydruid` | `druid://:@:/druid/v2/sql` | -| [Apache Hive](/docs/configuration/databases#hive) | `pip install pyhive` | `hive://hive@{hostname}:{port}/{database}` | -| [Apache Impala](/docs/configuration/databases#apache-impala) | `pip install impyla` | `impala://{hostname}:{port}/{database}` | -| [Apache Kylin](/docs/configuration/databases#apache-kylin) | `pip install kylinpy` | `kylin://:@:/?=&=` | -| [Apache Pinot](/docs/configuration/databases#apache-pinot) | `pip install pinotdb` | `pinot://BROKER:5436/query?server=http://CONTROLLER:5983/` | -| [Apache Solr](/docs/configuration/databases#apache-solr) | `pip install sqlalchemy-solr` | `solr://{username}:{password}@{hostname}:{port}/{server_path}/{collection}` | -| [Apache Spark SQL](/docs/configuration/databases#apache-spark-sql) | `pip install pyhive` | `hive://hive@{hostname}:{port}/{database}` | -| [Arc - Apache Arrow](/docs/configuration/databases#arc-arrow) | `pip install arc-superset-arrow` | `arc+arrow://{api_key}@{hostname}:{port}/{database}` | -| [Arc - JSON](/docs/configuration/databases#arc-json) | `pip install arc-superset-dialect` | `arc+json://{api_key}@{hostname}:{port}/{database}` | -| [Ascend.io](/docs/configuration/databases#ascendio) | `pip install impyla` | `ascend://{username}:{password}@{hostname}:{port}/{database}?auth_mechanism=PLAIN;use_ssl=true` | -| [Azure MS SQL](/docs/configuration/databases#sql-server) | `pip install pymssql` | `mssql+pymssql://UserName@presetSQL:TestPassword@presetSQL.database.windows.net:1433/TestSchema` | -| [ClickHouse](/docs/configuration/databases#clickhouse) | `pip install clickhouse-connect` | `clickhousedb://{username}:{password}@{hostname}:{port}/{database}` | -| [Cloudflare D1](/docs/configuration/databases#cloudflare-d1) | `pip install superset-engine-d1` or `pip install apache_superset[d1]` | `d1://{cloudflare_account_id}:{cloudflare_api_token}@{cloudflare_d1_database_id}` | -| [CockroachDB](/docs/configuration/databases#cockroachdb) | `pip install cockroachdb` | `cockroachdb://root@{hostname}:{port}/{database}?sslmode=disable` | -| [Couchbase](/docs/configuration/databases#couchbase) | `pip install couchbase-sqlalchemy` | `couchbase://{username}:{password}@{hostname}:{port}?truststorepath={ssl certificate path}` | -| [CrateDB](/docs/configuration/databases#cratedb) | `pip install sqlalchemy-cratedb` | `crate://{username}:{password}@{hostname}:{port}`, often useful: `?ssl=true/false` or `?schema=testdrive`. | -| [Denodo](/docs/configuration/databases#denodo) | `pip install denodo-sqlalchemy` | `denodo://{username}:{password}@{hostname}:{port}/{database}` | -| [Dremio](/docs/configuration/databases#dremio) | `pip install sqlalchemy_dremio` |`dremio+flight://{username}:{password}@{host}:32010`, often useful: `?UseEncryption=true/false`. For Legacy ODBC: `dremio+pyodbc://{username}:{password}@{host}:31010` | -| [Elasticsearch](/docs/configuration/databases#elasticsearch) | `pip install elasticsearch-dbapi` | `elasticsearch+http://{user}:{password}@{host}:9200/` | -| [Exasol](/docs/configuration/databases#exasol) | `pip install sqlalchemy-exasol` | `exa+pyodbc://{username}:{password}@{hostname}:{port}/my_schema?CONNECTIONLCALL=en_US.UTF-8&driver=EXAODBC` | -| [Google BigQuery](/docs/configuration/databases#google-bigquery) | `pip install sqlalchemy-bigquery` | `bigquery://{project_id}` | -| [Google Sheets](/docs/configuration/databases#google-sheets) | `pip install shillelagh[gsheetsapi]` | `gsheets://` | -| [Firebolt](/docs/configuration/databases#firebolt) | `pip install firebolt-sqlalchemy` | `firebolt://{client_id}:{client_secret}@{database}/{engine_name}?account_name={name}` | -| [Hologres](/docs/configuration/databases#hologres) | `pip install psycopg2` | `postgresql+psycopg2://:@/` | -| [IBM Db2](/docs/configuration/databases#ibm-db2) | `pip install ibm_db_sa` | `db2+ibm_db://` | -| [IBM Netezza Performance Server](/docs/configuration/databases#ibm-netezza-performance-server) | `pip install nzalchemy` | `netezza+nzpy://:@/` | -| [MySQL](/docs/configuration/databases#mysql) | `pip install mysqlclient` | `mysql://:@/` | -| [OceanBase](/docs/configuration/databases#oceanbase) | `pip install oceanbase_py` | `oceanbase://:@/` | -| [Oracle](/docs/configuration/databases#oracle) | `pip install oracledb` | `oracle://:@:` | -| [Parseable](/docs/configuration/databases#parseable) | `pip install sqlalchemy-parseable` | `parseable://:@/` | -| [PostgreSQL](/docs/configuration/databases#postgres) | `pip install psycopg2` | `postgresql://:@/` | -| [Presto](/docs/configuration/databases#presto) | `pip install pyhive` | `presto://{username}:{password}@{hostname}:{port}/{database}` | -| [SAP Hana](/docs/configuration/databases#hana) | `pip install hdbcli sqlalchemy-hana` or `pip install apache_superset[hana]` | `hana://{username}:{password}@{host}:{port}` | -| [SingleStore](/docs/configuration/databases#singlestore) | `pip install sqlalchemy-singlestoredb` | `singlestoredb://{username}:{password}@{host}:{port}/{database}` | -| [StarRocks](/docs/configuration/databases#starrocks) | `pip install starrocks` | `starrocks://:@:/.` | -| [Snowflake](/docs/configuration/databases#snowflake) | `pip install snowflake-sqlalchemy` | `snowflake://{user}:{password}@{account}.{region}/{database}?role={role}&warehouse={warehouse}` | -| SQLite | No additional library needed | `sqlite://path/to/file.db?check_same_thread=false` | -| [SQL Server](/docs/configuration/databases#sql-server) | `pip install pymssql` | `mssql+pymssql://:@:/` | -| [TDengine](/docs/configuration/databases#tdengine) | `pip install taospy` `pip install taos-ws-py` | `taosws://:@:` | -| [Teradata](/docs/configuration/databases#teradata) | `pip install teradatasqlalchemy` | `teradatasql://{user}:{password}@{host}` | -| [TimescaleDB](/docs/configuration/databases#timescaledb) | `pip install psycopg2` | `postgresql://:@:/` | -| [Trino](/docs/configuration/databases#trino) | `pip install trino` | `trino://{username}:{password}@{hostname}:{port}/{catalog}` | -| [Vertica](/docs/configuration/databases#vertica) | `pip install sqlalchemy-vertica-python` | `vertica+vertica_python://:@/` | -| [YDB](/docs/configuration/databases#ydb) | `pip install ydb-sqlalchemy` | `ydb://{host}:{port}/{database_name}` | -| [YugabyteDB](/docs/configuration/databases#yugabytedb) | `pip install psycopg2` | `postgresql://:@/` | - ---- - -Note that many other databases are supported, the main criteria being the existence of a functional -SQLAlchemy dialect and Python driver. Searching for the keyword "sqlalchemy + (database name)" -should help get you to the right place. - -If your database or data engine isn't on the list but a SQL interface -exists, please file an issue on the -[Superset GitHub repo](https://github.com/apache/superset/issues), so we can work on documenting and -supporting it. - -:::resources -- [Tutorial: Building a Database Connector for Superset](https://preset.io/blog/building-database-connector/) -::: - -### Installing Drivers in Docker Images - -Superset requires a Python database driver to be installed for each additional -type of database you want to connect to. - -In this example, we'll walk through how to install the MySQL connector library. -The connector library installation process is the same for all additional libraries. - -#### 1. Determine the driver you need - -Consult the [list of database drivers](/docs/configuration/databases) -and find the PyPI package needed to connect to your database. In this example, we're connecting -to a MySQL database, so we'll need the `mysqlclient` connector library. - -#### 2. Install the driver in the container - -We need to get the `mysqlclient` library installed into the Superset docker container -(it doesn't matter if it's installed on the host machine). We could enter the running -container with `docker exec -it bash` and run `pip install mysqlclient` -there, but that wouldn't persist permanently. - -To address this, the Superset `docker compose` deployment uses the convention -of a `requirements-local.txt` file. All packages listed in this file will be installed -into the container from PyPI at runtime. This file will be ignored by Git for -the purposes of local development. - -Create the file `requirements-local.txt` in a subdirectory called `docker` that -exists in the directory with your `docker-compose.yml` or `docker-compose-non-dev.yml` file. - -```bash -# Run from the repo root: -touch ./docker/requirements-local.txt -``` - -Add the driver identified in step above. You can use a text editor or do -it from the command line like: - -```bash -echo "mysqlclient" >> ./docker/requirements-local.txt -``` - -**If you are running a stock (non-customized) Superset image**, you are done. -Launch Superset with `docker compose -f docker-compose-non-dev.yml up` and -the driver should be present. - -You can check its presence by entering the running container with -`docker exec -it bash` and running `pip freeze`. The PyPI package should -be present in the printed list. - -**If you're running a customized docker image**, rebuild your local image with the new -driver baked in: - -```bash -docker compose build --force-rm -``` - -After the rebuild of the Docker images is complete, relaunch Superset by -running `docker compose up`. - -#### 3. Connect to MySQL - -Now that you've got a MySQL driver installed in your container, you should be able to connect -to your database via the Superset web UI. - -As an admin user, go to Settings -> Data: Database Connections and click the +DATABASE button. -From there, follow the steps on the -[Using Database Connection UI page](/docs/configuration/databases#connecting-through-the-ui). - -Consult the page for your specific database type in the Superset documentation to determine -the connection string and any other parameters you need to input. For instance, -on the [MySQL page](/docs/configuration/databases#mysql), we see that the connection string -to a local MySQL database differs depending on whether the setup is running on Linux or Mac. - -Click the “Test Connection” button, which should result in a popup message saying, -"Connection looks good!". - -#### 4. Troubleshooting - -If the test fails, review your docker logs for error messages. Superset uses SQLAlchemy -to connect to databases; to troubleshoot the connection string for your database, you might -start Python in the Superset application container or host environment and try to connect -directly to the desired database and fetch data. This eliminates Superset for the -purposes of isolating the problem. - -Repeat this process for each type of database you want Superset to connect to. - -### Database-specific Instructions - -#### Ascend.io - -The recommended connector library to Ascend.io is [impyla](https://github.com/cloudera/impyla). - -The expected connection string is formatted as follows: - -``` -ascend://{username}:{password}@{hostname}:{port}/{database}?auth_mechanism=PLAIN;use_ssl=true -``` - -#### Apache Doris - -The [sqlalchemy-doris](https://pypi.org/project/pydoris/) library is the recommended way to connect to Apache Doris through SQLAlchemy. - -You'll need the following setting values to form the connection string: - -- **User**: User Name -- **Password**: Password -- **Host**: Doris FE Host -- **Port**: Doris FE port -- **Catalog**: Catalog Name -- **Database**: Database Name - -Here's what the connection string looks like: - -``` -doris://:@:/. -``` - -:::resources -- [Apache Doris Docs: Superset Integration](https://doris.apache.org/docs/ecosystem/bi/apache-superset/) -::: - -#### AWS Athena - -##### PyAthenaJDBC - -[PyAthenaJDBC](https://pypi.org/project/PyAthenaJDBC/) is a Python DB 2.0 compliant wrapper for the -[Amazon Athena JDBC driver](https://docs.aws.amazon.com/athena/latest/ug/connect-with-jdbc.html). - -The connection string for Amazon Athena is as follows: - -``` -awsathena+jdbc://{aws_access_key_id}:{aws_secret_access_key}@athena.{region_name}.amazonaws.com/{schema_name}?s3_staging_dir={s3_staging_dir}&... -``` - -Note that you'll need to escape & encode when forming the connection string like so: - -``` -s3://... -> s3%3A//... -``` - -##### PyAthena - -You can also use the [PyAthena library](https://pypi.org/project/PyAthena/) (no Java required) with the -following connection string: - -``` -awsathena+rest://{aws_access_key_id}:{aws_secret_access_key}@athena.{region_name}.amazonaws.com/{schema_name}?s3_staging_dir={s3_staging_dir}&... -``` - -The PyAthena library also allows to assume a specific IAM role which you can define by adding following parameters in Superset's Athena database connection UI under ADVANCED --> Other --> ENGINE PARAMETERS. - -```json -{ - "connect_args": { - "role_arn": "" - } -} -``` - -#### AWS DynamoDB - -##### PyDynamoDB - -[PyDynamoDB](https://pypi.org/project/PyDynamoDB/) is a Python DB API 2.0 (PEP 249) client for Amazon DynamoDB. - -The connection string for Amazon DynamoDB is as follows: - -``` -dynamodb://{aws_access_key_id}:{aws_secret_access_key}@dynamodb.{region_name}.amazonaws.com:443?connector=superset -``` - -To get more documentation, please visit: [PyDynamoDB WIKI](https://github.com/passren/PyDynamoDB/wiki/5.-Superset). - -#### AWS Redshift - -The [sqlalchemy-redshift](https://pypi.org/project/sqlalchemy-redshift/) library is the recommended -way to connect to Redshift through SQLAlchemy. - -This dialect requires either [redshift_connector](https://pypi.org/project/redshift-connector/) or [psycopg2](https://pypi.org/project/psycopg2/) to work properly. - -You'll need to set the following values to form the connection string: - -- **User Name**: userName -- **Password**: DBPassword -- **Database Host**: AWS Endpoint -- **Database Name**: Database Name -- **Port**: default 5439 - -##### psycopg2 - -Here's what the SQLALCHEMY URI looks like: - -``` -redshift+psycopg2://:@:5439/ -``` - -##### redshift_connector - -Here's what the SQLALCHEMY URI looks like: - -``` -redshift+redshift_connector://:@:5439/ -``` - -###### Using IAM-based credentials with Redshift cluster - -[Amazon redshift cluster](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-clusters.html) also supports generating temporary IAM-based database user credentials. - -Your superset app's [IAM role should have permissions](https://docs.aws.amazon.com/redshift/latest/mgmt/generating-iam-credentials-role-permissions.html) to call the `redshift:GetClusterCredentials` operation. - -You have to define the following arguments in Superset's redshift database connection UI under ADVANCED --> Others --> ENGINE PARAMETERS. - -``` -{"connect_args":{"iam":true,"database":"","cluster_identifier":"","db_user":""}} -``` - -and SQLALCHEMY URI should be set to `redshift+redshift_connector://` - -###### Using IAM-based credentials with Redshift serverless - -[Redshift serverless](https://docs.aws.amazon.com/redshift/latest/mgmt/serverless-whatis.html) supports connection using IAM roles. - -Your superset app's IAM role should have `redshift-serverless:GetCredentials` and `redshift-serverless:GetWorkgroup` permissions on Redshift serverless workgroup. - -You have to define the following arguments in Superset's redshift database connection UI under ADVANCED --> Others --> ENGINE PARAMETERS. - -``` -{"connect_args":{"iam":true,"is_serverless":true,"serverless_acct_id":"","serverless_work_group":"","database":"","user":"IAMR:"}} -``` - -#### ClickHouse - -To use ClickHouse with Superset, you will need to install the `clickhouse-connect` Python library: - -If running Superset using Docker Compose, add the following to your `./docker/requirements-local.txt` file: - -``` -clickhouse-connect>=0.6.8 -``` - -The recommended connector library for ClickHouse is -[clickhouse-connect](https://github.com/ClickHouse/clickhouse-connect). - -The expected connection string is formatted as follows: - -``` -clickhousedb://:@:/[?options…]clickhouse://{username}:{password}@{hostname}:{port}/{database} -``` - -Here's a concrete example of a real connection string: - -``` -clickhousedb://demo:demo@github.demo.trial.altinity.cloud/default?secure=true -``` - -If you're using Clickhouse locally on your computer, you can get away with using a http protocol URL that -uses the default user without a password (and doesn't encrypt the connection): - -``` -clickhousedb://localhost/default -``` - -:::resources -- [ClickHouse Docs: Superset Integration](https://clickhouse.com/docs/integrations/superset) -- [Altinity: Connect ClickHouse to Superset](https://docs.altinity.com/integrations/clickhouse-and-superset/connect-clickhouse-to-superset/) -- [Instaclustr: Connecting to ClickHouse from Superset](https://www.instaclustr.com/support/documentation/clickhouse/using-a-clickhouse-cluster/connecting-to-clickhouse-from-apache-superset/) -- [Blog: ClickHouse and Apache Superset](https://preset.io/blog/2021-5-26-clickhouse-superset/) -::: - -#### Cloudflare D1 - -To use Cloudflare D1 with superset, install the [superset-engine-d1](https://github.com/sqlalchemy-cf-d1/superset-engine-d1) library. - -``` -pip install superset-engine-d1 -``` - -The expected connection string is formatted as follows: - -``` -d1://{cloudflare_account_id}:{cloudflare_api_token}@{cloudflare_d1_database_id} -``` - -#### CockroachDB - -The recommended connector library for CockroachDB is -[sqlalchemy-cockroachdb](https://github.com/cockroachdb/sqlalchemy-cockroachdb). - -The expected connection string is formatted as follows: - -``` -cockroachdb://root@{hostname}:{port}/{database}?sslmode=disable -``` - -#### Couchbase - -The Couchbase's Superset connection is designed to support two services: Couchbase Analytics and Couchbase Columnar. -The recommended connector library for couchbase is -[couchbase-sqlalchemy](https://github.com/couchbase/couchbase-sqlalchemy). - -``` -pip install couchbase-sqlalchemy -``` - -The expected connection string is formatted as follows: - -``` -couchbase://{username}:{password}@{hostname}:{port}?truststorepath={certificate path}?ssl={true/false} -``` - -#### CrateDB - -The connector library for CrateDB is [sqlalchemy-cratedb]. -We recommend to add the following item to your `requirements.txt` file: - -``` -sqlalchemy-cratedb>=0.40.1,<1 -``` - -An SQLAlchemy connection string for [CrateDB Self-Managed] on localhost, -for evaluation purposes, looks like this: - -``` -crate://crate@127.0.0.1:4200 -``` - -An SQLAlchemy connection string for connecting to [CrateDB Cloud] looks like -this: - -``` -crate://:@.cratedb.net:4200/?ssl=true -``` - -Follow the steps [here](/docs/configuration/databases#installing-database-drivers) -to install the CrateDB connector package when setting up Superset locally using -Docker Compose. - -``` -echo "sqlalchemy-cratedb" >> ./docker/requirements-local.txt -``` - -:::resources -- [CrateDB Docs: Apache Superset Integration](https://cratedb.com/docs/guide/integrate/apache-superset/index.html) -- [Blog: Visualizing Time-Series Data with CrateDB and Superset](https://preset.io/blog/timeseries-cratedb-superset/) -::: - -[CrateDB Cloud]: https://cratedb.com/product/cloud -[CrateDB Self-Managed]: https://cratedb.com/product/self-managed -[sqlalchemy-cratedb]: https://pypi.org/project/sqlalchemy-cratedb/ - -#### Databend - -The recommended connector library for Databend is [databend-sqlalchemy](https://pypi.org/project/databend-sqlalchemy/). -Superset has been tested on `databend-sqlalchemy>=0.2.3`. - -The recommended connection string is: - -``` -databend://{username}:{password}@{host}:{port}/{database_name} -``` - -Here's a connection string example of Superset connecting to a Databend database: - -``` -databend://user:password@localhost:8000/default?secure=false -``` - -#### Databricks - -Databricks now offer a native DB API 2.0 driver, `databricks-sql-connector`, that can be used with the `sqlalchemy-databricks` dialect. You can install both with: - -```bash -pip install "apache-superset[databricks]" -``` - -To use the Hive connector you need the following information from your cluster: - -- Server hostname -- Port -- HTTP path - -These can be found under "Configuration" -> "Advanced Options" -> "JDBC/ODBC". - -You also need an access token from "Settings" -> "User Settings" -> "Access Tokens". - -Once you have all this information, add a database of type "Databricks Native Connector" and use the following SQLAlchemy URI: - -``` -databricks+connector://token:{access_token}@{server_hostname}:{port}/{database_name} -``` - -You also need to add the following configuration to "Other" -> "Engine Parameters", with your HTTP path: - -```json -{ - "connect_args": {"http_path": "sql/protocolv1/o/****"} -} -``` - -##### Older driver - -Originally Superset used `databricks-dbapi` to connect to Databricks. You might want to try it if you're having problems with the official Databricks connector: - -```bash -pip install "databricks-dbapi[sqlalchemy]" -``` - -There are two ways to connect to Databricks when using `databricks-dbapi`: using a Hive connector or an ODBC connector. Both ways work similarly, but only ODBC can be used to connect to [SQL endpoints](https://docs.databricks.com/sql/admin/sql-endpoints.html). - -#### Hive - -To connect to a Hive cluster add a database of type "Databricks Interactive Cluster" in Superset, and use the following SQLAlchemy URI: - -``` -databricks+pyhive://token:{access_token}@{server_hostname}:{port}/{database_name} -``` - -You also need to add the following configuration to "Other" -> "Engine Parameters", with your HTTP path: - -```json -{"connect_args": {"http_path": "sql/protocolv1/o/****"}} -``` - -#### ODBC - -For ODBC you first need to install the [ODBC drivers for your platform](https://databricks.com/spark/odbc-drivers-download). - -For a regular connection use this as the SQLAlchemy URI after selecting either "Databricks Interactive Cluster" or "Databricks SQL Endpoint" for the database, depending on your use case: - -``` -databricks+pyodbc://token:{access_token}@{server_hostname}:{port}/{database_name} -``` - -And for the connection arguments: - -```json -{"connect_args": {"http_path": "sql/protocolv1/o/****", "driver_path": "/path/to/odbc/driver"}} -``` - -The driver path should be: - -- `/Library/simba/spark/lib/libsparkodbc_sbu.dylib` (Mac OS) -- `/opt/simba/spark/lib/64/libsparkodbc_sb64.so` (Linux) - -For a connection to a SQL endpoint you need to use the HTTP path from the endpoint: - -```json -{"connect_args": {"http_path": "/sql/1.0/endpoints/****", "driver_path": "/path/to/odbc/driver"}} -``` - -#### Denodo - -The recommended connector library for Denodo is -[denodo-sqlalchemy](https://pypi.org/project/denodo-sqlalchemy/). - -The expected connection string is formatted as follows (default port is 9996): - -``` -denodo://{username}:{password}@{hostname}:{port}/{database} -``` - -#### Dremio - -The recommended connector library for Dremio is -[sqlalchemy_dremio](https://pypi.org/project/sqlalchemy-dremio/). - -The expected connection string for ODBC (Default port is 31010) is formatted as follows: - -``` -dremio+pyodbc://{username}:{password}@{host}:{port}/{database_name}/dremio?SSL=1 -``` - -The expected connection string for Arrow Flight (Dremio 4.9.1+. Default port is 32010) is formatted as follows: - -``` -dremio+flight://{username}:{password}@{host}:{port}/dremio -``` - -:::resources -- [Dremio Docs: Superset Integration](https://docs.dremio.com/current/client-applications/superset/) -- [Blog: Connecting Dremio to Apache Superset](https://www.dremio.com/tutorials/dremio-apache-superset/) -::: - -#### Apache Drill - -##### SQLAlchemy - -The recommended way to connect to Apache Drill is through SQLAlchemy. You can use the -[sqlalchemy-drill](https://github.com/JohnOmernik/sqlalchemy-drill) package. - -Once that is done, you can connect to Drill in two ways, either via the REST interface or by JDBC. -If you are connecting via JDBC, you must have the Drill JDBC Driver installed. - -The basic connection string for Drill looks like this: - -``` -drill+sadrill://:@:/?use_ssl=True -``` - -To connect to Drill running on a local machine running in embedded mode you can use the following -connection string: - -``` -drill+sadrill://localhost:8047/dfs?use_ssl=False -``` - -##### JDBC - -Connecting to Drill through JDBC is more complicated and we recommend following -[this tutorial](https://drill.apache.org/docs/using-the-jdbc-driver/). - -The connection string looks like: - -``` -drill+jdbc://:@: -``` - -##### ODBC - -We recommend reading the -[Apache Drill documentation](https://drill.apache.org/docs/installing-the-driver-on-linux/) and read -the [GitHub README](https://github.com/JohnOmernik/sqlalchemy-drill#usage-with-odbc) to learn how to -work with Drill through ODBC. - -:::resources -- [Tutorial: Query MongoDB in Superset with Apache Drill](https://medium.com/@thoren.lederer/query-data-from-mongodb-in-apache-superset-with-the-help-of-apache-drill-full-tutorial-b34c33eac6c1) -::: - -import useBaseUrl from "@docusaurus/useBaseUrl"; - -#### Apache Druid - -A native connector to Druid ships with Superset (behind the `DRUID_IS_ACTIVE` flag) but this is -slowly getting deprecated in favor of the SQLAlchemy / DBAPI connector made available in the -[pydruid library](https://pythonhosted.org/pydruid/). - -The connection string looks like: - -``` -druid://:@:/druid/v2/sql -``` - -Here's a breakdown of the key components of this connection string: - -- `User`: username portion of the credentials needed to connect to your database -- `Password`: password portion of the credentials needed to connect to your database -- `Host`: IP address (or URL) of the host machine that's running your database -- `Port`: specific port that's exposed on your host machine where your database is running - -##### Customizing Druid Connection - -When adding a connection to Druid, you can customize the connection a few different ways in the -**Add Database** form. - -**Custom Certificate** - -You can add certificates in the **Root Certificate** field when configuring the new database -connection to Druid: - -{" "} - -When using a custom certificate, pydruid will automatically use https scheme. - -**Disable SSL Verification** - -To disable SSL verification, add the following to the **Extras** field: - -``` -engine_params: -{"connect_args": - {"scheme": "https", "ssl_verify_cert": false}} -``` - -##### Aggregations - -Common aggregations or Druid metrics can be defined and used in Superset. The first and simpler use -case is to use the checkbox matrix exposed in your datasource’s edit view (**Sources -> Druid -Datasources -> [your datasource] -> Edit -> [tab] List Druid Column**). - -Clicking the GroupBy and Filterable checkboxes will make the column appear in the related dropdowns -while in the Explore view. Checking Count Distinct, Min, Max or Sum will result in creating new -metrics that will appear in the **List Druid Metric** tab upon saving the datasource. - -By editing these metrics, you’ll notice that their JSON element corresponds to Druid aggregation -definition. You can create your own aggregations manually from the **List Druid Metric** tab -following Druid documentation. - -##### Post-Aggregations - -Druid supports post aggregation and this works in Superset. All you have to do is create a metric, -much like you would create an aggregation manually, but specify `postagg` as a `Metric Type`. You -then have to provide a valid json post-aggregation definition (as specified in the Druid docs) in -the JSON field. - -:::resources -- [Blog: Real-Time Business Insights with Apache Druid and Superset](https://www.deep.bi/blog/real-time-business-insights-with-apache-druid-and-apache-superset) -::: - -#### Elasticsearch - -The recommended connector library for Elasticsearch is -[elasticsearch-dbapi](https://github.com/preset-io/elasticsearch-dbapi). - -The connection string for Elasticsearch looks like this: - -``` -elasticsearch+http://{user}:{password}@{host}:9200/ -``` - -**Using HTTPS** - -``` -elasticsearch+https://{user}:{password}@{host}:9200/ -``` - -Elasticsearch as a default limit of 10000 rows, so you can increase this limit on your cluster or -set Superset’s row limit on config - -``` -ROW_LIMIT = 10000 -``` - -You can query multiple indices on SQL Lab for example - -``` -SELECT timestamp, agent FROM "logstash" -``` - -But, to use visualizations for multiple indices you need to create an alias index on your cluster - -``` -POST /_aliases -{ - "actions" : [ - { "add" : { "index" : "logstash-**", "alias" : "logstash_all" } } - ] -} -``` - -Then register your table with the alias name logstash_all - -**Time zone** - -By default, Superset uses UTC time zone for elasticsearch query. If you need to specify a time zone, -please edit your Database and enter the settings of your specified time zone in the Other > ENGINE PARAMETERS: - -```json -{ - "connect_args": { - "time_zone": "Asia/Shanghai" - } -} -``` - -Another issue to note about the time zone problem is that before elasticsearch7.8, if you want to convert a string into a `DATETIME` object, -you need to use the `CAST` function,but this function does not support our `time_zone` setting. So it is recommended to upgrade to the version after elasticsearch7.8. -After elasticsearch7.8, you can use the `DATETIME_PARSE` function to solve this problem. -The DATETIME_PARSE function is to support our `time_zone` setting, and here you need to fill in your elasticsearch version number in the Other > VERSION setting. -the superset will use the `DATETIME_PARSE` function for conversion. - -**Disable SSL Verification** - -To disable SSL verification, add the following to the **SQLALCHEMY URI** field: - -``` -elasticsearch+https://{user}:{password}@{host}:9200/?verify_certs=False -``` - -:::resources -- [Blog: Superset Announces Elasticsearch Support](https://preset.io/blog/2019-12-16-elasticsearch-in-superset/) -::: - -#### Exasol - -The recommended connector library for Exasol is -[sqlalchemy-exasol](https://github.com/exasol/sqlalchemy-exasol). - -The connection string for Exasol looks like this: - -``` -exa+pyodbc://{username}:{password}@{hostname}:{port}/my_schema?CONNECTIONLCALL=en_US.UTF-8&driver=EXAODBC -``` - -#### Firebird - -The recommended connector library for Firebird is [sqlalchemy-firebird](https://pypi.org/project/sqlalchemy-firebird/). -Superset has been tested on `sqlalchemy-firebird>=0.7.0, <0.8`. - -The recommended connection string is: - -``` -firebird+fdb://{username}:{password}@{host}:{port}//{path_to_db_file} -``` - -Here's a connection string example of Superset connecting to a local Firebird database: - -``` -firebird+fdb://SYSDBA:masterkey@192.168.86.38:3050//Library/Frameworks/Firebird.framework/Versions/A/Resources/examples/empbuild/employee.fdb -``` - -#### Firebolt - -The recommended connector library for Firebolt is [firebolt-sqlalchemy](https://pypi.org/project/firebolt-sqlalchemy/). - -The recommended connection string is: - -``` -firebolt://{username}:{password}@{database}?account_name={name} -or -firebolt://{username}:{password}@{database}/{engine_name}?account_name={name} -``` - -It's also possible to connect using a service account: - -``` -firebolt://{client_id}:{client_secret}@{database}?account_name={name} -or -firebolt://{client_id}:{client_secret}@{database}/{engine_name}?account_name={name} -``` - -:::resources -- [Firebolt Docs: Connecting to Apache Superset](https://docs.firebolt.io/guides/integrations/connecting-to-apache-superset) -::: - -#### Google BigQuery - -The recommended connector library for BigQuery is -[sqlalchemy-bigquery](https://github.com/googleapis/python-bigquery-sqlalchemy). - -##### Install BigQuery Driver - -Follow the steps [here](/docs/configuration/databases#installing-drivers-in-docker-images) about how to -install new database drivers when setting up Superset locally via docker compose. - -```bash -echo "sqlalchemy-bigquery" >> ./docker/requirements-local.txt -``` - -##### Connecting to BigQuery - -When adding a new BigQuery connection in Superset, you'll need to add the GCP Service Account -credentials file (as a JSON). - -1. Create your Service Account via the Google Cloud Platform control panel, provide it access to the - appropriate BigQuery datasets, and download the JSON configuration file for the service account. -2. In Superset, you can either upload that JSON or add the JSON blob in the following format (this should be the content of your credential JSON file): - -```json -{ - "type": "service_account", - "project_id": "...", - "private_key_id": "...", - "private_key": "...", - "client_email": "...", - "client_id": "...", - "auth_uri": "...", - "token_uri": "...", - "auth_provider_x509_cert_url": "...", - "client_x509_cert_url": "..." - } -``` - -![CleanShot 2021-10-22 at 04 18 11](https://user-images.githubusercontent.com/52086618/138352958-a18ef9cb-8880-4ef1-88c1-452a9f1b8105.gif) - -3. Additionally, can connect via SQLAlchemy URI instead - - The connection string for BigQuery looks like: - - ``` - bigquery://{project_id} - ``` - - Go to the **Advanced** tab, Add a JSON blob to the **Secure Extra** field in the database configuration form with - the following format: - - ```json - { - "credentials_info": - } - ``` - - The resulting file should have this structure: - - ```json - { - "credentials_info": { - "type": "service_account", - "project_id": "...", - "private_key_id": "...", - "private_key": "...", - "client_email": "...", - "client_id": "...", - "auth_uri": "...", - "token_uri": "...", - "auth_provider_x509_cert_url": "...", - "client_x509_cert_url": "..." - } - } - ``` - -You should then be able to connect to your BigQuery datasets. - -![CleanShot 2021-10-22 at 04 47 08](https://user-images.githubusercontent.com/52086618/138354340-df57f477-d3e5-42d4-b032-d901c69d2213.gif) - -To be able to upload CSV or Excel files to BigQuery in Superset, you'll need to also add the -[pandas_gbq](https://github.com/pydata/pandas-gbq) library. - -Currently, the Google BigQuery Python SDK is not compatible with `gevent`, due to some dynamic monkeypatching on python core library by `gevent`. -So, when you deploy Superset with `gunicorn` server, you have to use worker type except `gevent`. - -:::resources -- [Tutorial: Build A StackOverflow Dashboard — Connecting Superset to BigQuery](https://preset.io/blog/2020-08-04-google-bigquery/) -::: - -#### Google Sheets - -Google Sheets has a very limited -[SQL API](https://developers.google.com/chart/interactive/docs/querylanguage). The recommended -connector library for Google Sheets is [shillelagh](https://github.com/betodealmeida/shillelagh). - -There are a few steps involved in connecting Superset to Google Sheets. - -:::resources -- [Tutorial: Connect Superset to Google Sheets](https://preset.io/blog/2020-06-01-connect-superset-google-sheets/) -::: - -#### Hana - -The recommended connector library is [sqlalchemy-hana](https://github.com/SAP/sqlalchemy-hana). - -The connection string is formatted as follows: - -``` -hana://{username}:{password}@{host}:{port} -``` - -#### Apache Hive - -The [pyhive](https://pypi.org/project/PyHive/) library is the recommended way to connect to Hive through SQLAlchemy. - -The expected connection string is formatted as follows: - -``` -hive://hive@{hostname}:{port}/{database} -``` - -:::resources -- [Cloudera: Connect Apache Hive to Superset](https://docs-archive.cloudera.com/HDPDocuments/HDP3/HDP-3.0.0/integrating-hive/content/hive_connect_hive_to_apache_superset.html) -::: - -#### Hologres - -Hologres is a real-time interactive analytics service developed by Alibaba Cloud. It is fully compatible with PostgreSQL 11 and integrates seamlessly with the big data ecosystem. - -Hologres sample connection parameters: - -- **User Name**: The AccessKey ID of your Alibaba Cloud account. -- **Password**: The AccessKey secret of your Alibaba Cloud account. -- **Database Host**: The public endpoint of the Hologres instance. -- **Database Name**: The name of the Hologres database. -- **Port**: The port number of the Hologres instance. - -The connection string looks like: - -``` -postgresql+psycopg2://{username}:{password}@{host}:{port}/{database} -``` - -#### IBM DB2 - -The [IBM_DB_SA](https://github.com/ibmdb/python-ibmdbsa/tree/master/ibm_db_sa) library provides a -Python / SQLAlchemy interface to IBM Data Servers. - -Here's the recommended connection string: - -``` -db2+ibm_db://{username}:{passport}@{hostname}:{port}/{database} -``` - -There are two DB2 dialect versions implemented in SQLAlchemy. If you are connecting to a DB2 version without `LIMIT [n]` syntax, the recommended connection string to be able to use the SQL Lab is: - -``` -ibm_db_sa://{username}:{passport}@{hostname}:{port}/{database} -``` - -#### Apache Impala - -The recommended connector library to Apache Impala is [impyla](https://github.com/cloudera/impyla). - -The expected connection string is formatted as follows: - -``` -impala://{hostname}:{port}/{database} -``` - -#### Kusto - -The recommended connector library for Kusto is -[sqlalchemy-kusto](https://pypi.org/project/sqlalchemy-kusto/2.0.0/)>=2.0.0. - -The connection string for Kusto (sql dialect) looks like this: - -``` -kustosql+https://{cluster_url}/{database}?azure_ad_client_id={azure_ad_client_id}&azure_ad_client_secret={azure_ad_client_secret}&azure_ad_tenant_id={azure_ad_tenant_id}&msi=False -``` - -The connection string for Kusto (kql dialect) looks like this: - -``` -kustokql+https://{cluster_url}/{database}?azure_ad_client_id={azure_ad_client_id}&azure_ad_client_secret={azure_ad_client_secret}&azure_ad_tenant_id={azure_ad_tenant_id}&msi=False -``` - -Make sure the user has privileges to access and use all required -databases/tables/views. - -#### Apache Kylin - -The recommended connector library for Apache Kylin is -[kylinpy](https://github.com/Kyligence/kylinpy). - -The expected connection string is formatted as follows: - -``` -kylin://:@:/?=&= -``` - -#### MySQL - -The recommended connector library for MySQL is [mysqlclient](https://pypi.org/project/mysqlclient/). - -Here's the connection string: - -``` -mysql://{username}:{password}@{host}/{database} -``` - -Host: - -- For Localhost: `localhost` or `127.0.0.1` -- Docker running on Linux: `172.18.0.1` -- For On Prem: IP address or Host name -- For Docker running in OSX: `docker.for.mac.host.internal` - Port: `3306` by default - -One problem with `mysqlclient` is that it will fail to connect to newer MySQL databases using `caching_sha2_password` for authentication, since the plugin is not included in the client. In this case, you should use [mysql-connector-python](https://pypi.org/project/mysql-connector-python/) instead: - -``` -mysql+mysqlconnector://{username}:{password}@{host}/{database} -``` - -#### IBM Netezza Performance Server - -The [nzalchemy](https://pypi.org/project/nzalchemy/) library provides a -Python / SQLAlchemy interface to IBM Netezza Performance Server (aka Netezza). - -Here's the recommended connection string: - -``` -netezza+nzpy://{username}:{password}@{hostname}:{port}/{database} -``` - -#### OceanBase - -The [sqlalchemy-oceanbase](https://pypi.org/project/oceanbase_py/) library is the recommended -way to connect to OceanBase through SQLAlchemy. - -The connection string for OceanBase looks like this: - -``` -oceanbase://:@:/ -``` - -#### Ocient DB - -The recommended connector library for Ocient is [sqlalchemy-ocient](https://pypi.org/project/sqlalchemy-ocient). - -##### Install the Ocient Driver - -```bash -pip install sqlalchemy-ocient -``` - -##### Connecting to Ocient - -The format of the Ocient DSN is: - -```shell -ocient://user:password@[host][:port][/database][?param1=value1&...] -``` - -#### Oracle - -The recommended connector library is -[cx_Oracle](https://cx-oracle.readthedocs.io/en/latest/user_guide/installation.html). - -The connection string is formatted as follows: - -``` -oracle://:@: -``` - -:::resources -- [Oracle Developers: Steps to use Apache Superset and Oracle Database](https://medium.com/oracledevs/steps-to-use-apache-superset-and-oracle-database-ae0858b4f134) -::: - -#### Parseable - -[Parseable](https://www.parseable.io) is a distributed log analytics database that provides SQL-like query interface for log data. The recommended connector library is [sqlalchemy-parseable](https://github.com/parseablehq/sqlalchemy-parseable). - -The connection string is formatted as follows: - -``` -parseable://:@:/ -``` - -For example: - -``` -parseable://admin:admin@demo.parseable.com:443/ingress-nginx -``` - -Note: The stream_name in the URI represents the Parseable logstream you want to query. You can use both HTTP (port 80) and HTTPS (port 443) connections. - -:::resources -- [Blog: Parseable with Apache Superset](https://www.parseable.com/blog/parseable-with-apache-superset) -::: - -#### Apache Pinot - -The recommended connector library for Apache Pinot is [pinotdb](https://pypi.org/project/pinotdb/). - -The expected connection string is formatted as follows: - -``` -pinot+http://:/query?controller=http://:/`` -``` - -The expected connection string using username and password is formatted as follows: - -``` -pinot://:@:/query/sql?controller=http://:/verify_ssl=true`` -``` - -If you want to use explore view or joins, window functions, etc. then enable [multi-stage query engine](https://docs.pinot.apache.org/reference/multi-stage-engine). -Add below argument while creating database connection in Advanced -> Other -> ENGINE PARAMETERS - -```json -{"connect_args":{"use_multistage_engine":"true"}} -``` - -:::resources -- [Apache Pinot Docs: Superset Integration](https://docs.pinot.apache.org/integrations/superset) -- [StarTree: Data Visualization with Apache Superset and Pinot](https://startree.ai/resources/data-visualization-with-apache-superset-and-pinot) -::: - -#### Postgres - -Note that, if you're using docker compose, the Postgres connector library [psycopg2](https://www.psycopg.org/docs/) -comes out of the box with Superset. - -Postgres sample connection parameters: - -- **User Name**: UserName -- **Password**: DBPassword -- **Database Host**: - - For Localhost: localhost or 127.0.0.1 - - For On Prem: IP address or Host name - - For AWS Endpoint -- **Database Name**: Database Name -- **Port**: default 5432 - -The connection string looks like: - -``` -postgresql://{username}:{password}@{host}:{port}/{database} -``` - -You can require SSL by adding `?sslmode=require` at the end: - -``` -postgresql://{username}:{password}@{host}:{port}/{database}?sslmode=require -``` - -You can read about the other SSL modes that Postgres supports in -[Table 31-1 from this documentation](https://www.postgresql.org/docs/9.1/libpq-ssl.html). - -More information about PostgreSQL connection options can be found in the -[SQLAlchemy docs](https://docs.sqlalchemy.org/en/13/dialects/postgresql.html#module-sqlalchemy.dialects.postgresql.psycopg2) -and the -[PostgreSQL docs](https://www.postgresql.org/docs/9.1/libpq-connect.html#LIBPQ-PQCONNECTDBPARAMS). - -:::resources -- [Blog: Data Visualization in PostgreSQL With Apache Superset](https://www.tigerdata.com/blog/data-visualization-in-postgresql-with-apache-superset) -::: - -#### QuestDB - -[QuestDB](https://questdb.io/) is a high-performance, open-source time-series database with SQL support. -The recommended connector library is the PostgreSQL driver [psycopg2](https://www.psycopg.org/docs/), -as QuestDB supports the PostgreSQL wire protocol. - -The connection string is formatted as follows: - -``` -postgresql+psycopg2://{username}:{password}@{hostname}:{port}/{database} -``` - -The default port for QuestDB's PostgreSQL interface is `8812`. - -:::resources -- [QuestDB Docs: Apache Superset Integration](https://questdb.com/docs/third-party-tools/superset/) -::: - -#### Presto - -The [pyhive](https://pypi.org/project/PyHive/) library is the recommended way to connect to Presto through SQLAlchemy. - -The expected connection string is formatted as follows: - -``` -presto://{hostname}:{port}/{database} -``` - -You can pass in a username and password as well: - -``` -presto://{username}:{password}@{hostname}:{port}/{database} -``` - -Here is an example connection string with values: - -``` -presto://datascientist:securepassword@presto.example.com:8080/hive -``` - -By default Superset assumes the most recent version of Presto is being used when querying the -datasource. If you’re using an older version of Presto, you can configure it in the extra parameter: - -```json -{ - "version": "0.123" -} -``` - -SSL Secure extra add json config to extra connection information. - -```json - { - "connect_args": - {"protocol": "https", - "requests_kwargs":{"verify":false} - } -} -``` - -:::resources -- [Tutorial: Presto SQL + S3 Data + Superset Data Lake](https://hackernoon.com/presto-sql-s3-data-superset-data-lake) -::: - -#### RisingWave - -The recommended connector library for RisingWave is -[sqlalchemy-risingwave](https://github.com/risingwavelabs/sqlalchemy-risingwave). - -The expected connection string is formatted as follows: - -``` -risingwave://root@{hostname}:{port}/{database}?sslmode=disable -``` - -#### Snowflake - -##### Install Snowflake Driver - -Follow the steps [here](/docs/configuration/databases#installing-database-drivers) about how to -install new database drivers when setting up Superset locally via docker compose. - -```bash -echo "snowflake-sqlalchemy" >> ./docker/requirements-local.txt -``` - -The recommended connector library for Snowflake is -[snowflake-sqlalchemy](https://pypi.org/project/snowflake-sqlalchemy/). - -The connection string for Snowflake looks like this: - -``` -snowflake://{user}:{password}@{account}.{region}/{database}?role={role}&warehouse={warehouse} -``` - -The schema is not necessary in the connection string, as it is defined per table/query. The role and -warehouse can be omitted if defaults are defined for the user, i.e. - -``` -snowflake://{user}:{password}@{account}.{region}/{database} -``` - -Make sure the user has privileges to access and use all required -databases/schemas/tables/views/warehouses, as the Snowflake SQLAlchemy engine does not test for -user/role rights during engine creation by default. However, when pressing the “Test Connection” -button in the Create or Edit Database dialog, user/role credentials are validated by passing -“validate_default_parameters”: True to the connect() method during engine creation. If the user/role -is not authorized to access the database, an error is recorded in the Superset logs. - -And if you want connect Snowflake with [Key Pair Authentication](https://docs.snowflake.com/en/user-guide/key-pair-auth.html#step-6-configure-the-snowflake-client-to-use-key-pair-authentication). -Please make sure you have the key pair and the public key is registered in Snowflake. -To connect Snowflake with Key Pair Authentication, you need to add the following parameters to "SECURE EXTRA" field. - -***Please note that you need to merge multi-line private key content to one line and insert `\n` between each line*** - -```json -{ - "auth_method": "keypair", - "auth_params": { - "privatekey_body": "-----BEGIN ENCRYPTED PRIVATE KEY-----\n...\n...\n-----END ENCRYPTED PRIVATE KEY-----", - "privatekey_pass":"Your Private Key Password" - } - } -``` - -If your private key is stored on server, you can replace "privatekey_body" with “privatekey_path” in parameter. - -```json -{ - "auth_method": "keypair", - "auth_params": { - "privatekey_path":"Your Private Key Path", - "privatekey_pass":"Your Private Key Password" - } -} -``` - -:::resources -- [Snowflake Builders Blog: Building Real-Time Operational Dashboards with Apache Superset and Snowflake](https://medium.com/snowflake/building-real-time-operational-dashboards-with-apache-superset-and-snowflake-23f625e07d7c) -::: - -#### Apache Solr - -The [sqlalchemy-solr](https://pypi.org/project/sqlalchemy-solr/) library provides a -Python / SQLAlchemy interface to Apache Solr. - -The connection string for Solr looks like this: - -``` -solr://{username}:{password}@{host}:{port}/{server_path}/{collection}[/?use_ssl=true|false] -``` - -#### Apache Spark SQL - -The recommended connector library for Apache Spark SQL [pyhive](https://pypi.org/project/PyHive/). - -The expected connection string is formatted as follows: - -``` -hive://hive@{hostname}:{port}/{database} -``` - -:::resources -- [Tutorial: How to Connect Apache Superset with Apache SparkSQL](https://medium.com/free-or-open-source-software/how-to-connect-apache-superset-with-apache-sparksql-50efe48ac0e4) -::: - -#### Arc - -There are two ways to connect Superset to Arc: - -**1. Arc with Apache Arrow (Recommended)** - -The recommended connector library for Arc with Apache Arrow support is [arc-superset-arrow](https://pypi.org/project/arc-superset-arrow/). - -The connection string looks like: - -``` -arc+arrow://{api_key}@{hostname}:{port}/{database} -``` - -**2. Arc with JSON** - -Alternatively, you can use the JSON connector [arc-superset-dialect](https://pypi.org/project/arc-superset-dialect/). - -The connection string looks like: - -``` -arc+json://{api_key}@{hostname}:{port}/{database} -``` - -Arc supports multiple databases (schemas) within a single instance. In Superset, each Arc database appears as a schema in the SQL Lab. - -**Note:** The Arrow dialect (`arc-superset-arrow`) is recommended for production use as it provides 3-5x better performance using Apache Arrow IPC binary format. - -#### SQL Server - -The recommended connector library for SQL Server is [pymssql](https://github.com/pymssql/pymssql). - -The connection string for SQL Server looks like this: - -``` -mssql+pymssql://:@:/ -``` - -It is also possible to connect using [pyodbc](https://pypi.org/project/pyodbc) with the parameter [odbc_connect](https://docs.sqlalchemy.org/en/14/dialects/mssql.html#pass-through-exact-pyodbc-string) - -The connection string for SQL Server looks like this: - -``` -mssql+pyodbc:///?odbc_connect=Driver%3D%7BODBC+Driver+17+for+SQL+Server%7D%3BServer%3Dtcp%3A%3Cmy_server%3E%2C1433%3BDatabase%3Dmy_database%3BUid%3Dmy_user_name%3BPwd%3Dmy_password%3BEncrypt%3Dyes%3BConnection+Timeout%3D30 -``` - -:::note -You might have noticed that some special charecters are used in the above connection string. For example see the `odbc_connect` parameter. The value is `Driver%3D%7BODBC+Driver+17+for+SQL+Server%7D%3B` which is a URL-encoded form of `Driver={ODBC+Driver+17+for+SQL+Server};`. It's important to give the connection string is URL encoded. - -For more information about this check the [sqlalchemy documentation](https://docs.sqlalchemy.org/en/20/core/engines.html#escaping-special-characters-such-as-signs-in-passwords). Which says `When constructing a fully formed URL string to pass to create_engine(), special characters such as those that may be used in the user and password need to be URL encoded to be parsed correctly. This includes the @ sign.` -::: - -#### SingleStore - -The recommended connector library for SingleStore is -[sqlalchemy-singlestoredb](https://github.com/singlestore-labs/sqlalchemy-singlestoredb). - -The expected connection string is formatted as follows: - -``` -singlestoredb://{username}:{password}@{host}:{port}/{database} -``` - -#### StarRocks - -The [sqlalchemy-starrocks](https://pypi.org/project/starrocks/) library is the recommended -way to connect to StarRocks through SQLAlchemy. - -You'll need to the following setting values to form the connection string: - -- **User**: User Name -- **Password**: DBPassword -- **Host**: StarRocks FE Host -- **Catalog**: Catalog Name -- **Database**: Database Name -- **Port**: StarRocks FE port - -Here's what the connection string looks like: - -``` -starrocks://:@:/. -``` - -:::resources -- [StarRocks Docs: Superset Integration](https://docs.starrocks.io/docs/integrations/BI_integrations/Superset/) -::: - -#### TDengine - -[TDengine](https://www.tdengine.com) is a High-Performance, Scalable Time-Series Database for Industrial IoT and provides SQL-like query interface. - -The recommended connector library for TDengine is [taospy](https://pypi.org/project/taospy/) and [taos-ws-py](https://pypi.org/project/taos-ws-py/) - -The expected connection string is formatted as follows: - -``` -taosws://:@: -``` - -For example: - -``` -taosws://root:taosdata@127.0.0.1:6041 -``` - -#### Teradata - -The recommended connector library is -[teradatasqlalchemy](https://pypi.org/project/teradatasqlalchemy/). - -The connection string for Teradata looks like this: - -``` -teradatasql://{user}:{password}@{host} -``` - -#### ODBC Driver - -There's also an older connector named - [sqlalchemy-teradata](https://github.com/Teradata/sqlalchemy-teradata) that - requires the installation of ODBC drivers. The Teradata ODBC Drivers - are available -here: https://downloads.teradata.com/download/connectivity/odbc-driver/linux - -Here are the required environment variables: - -```bash -export ODBCINI=/.../teradata/client/ODBC_64/odbc.ini -export ODBCINST=/.../teradata/client/ODBC_64/odbcinst.ini -``` - -We recommend using the first library because of the - lack of requirement around ODBC drivers and - because it's more regularly updated. - -#### TimescaleDB - -[TimescaleDB](https://www.timescale.com) is the open-source relational database for time-series and analytics to build powerful data-intensive applications. -TimescaleDB is a PostgreSQL extension, and you can use the standard PostgreSQL connector library, [psycopg2](https://www.psycopg.org/docs/), to connect to the database. - -If you're using docker compose, psycopg2 comes out of the box with Superset. - -TimescaleDB sample connection parameters: - -- **User Name**: User -- **Password**: Password -- **Database Host**: - - For Localhost: localhost or 127.0.0.1 - - For On Prem: IP address or Host name - - For [Timescale Cloud](https://console.cloud.timescale.com) service: Host name - - For [Managed Service for TimescaleDB](https://portal.managed.timescale.com) service: Host name -- **Database Name**: Database Name -- **Port**: default 5432 or Port number of the service - -The connection string looks like: - -``` -postgresql://{username}:{password}@{host}:{port}/{database name} -``` - -You can require SSL by adding `?sslmode=require` at the end (e.g. in case you use [Timescale Cloud](https://www.timescale.com/cloud)): - -``` -postgresql://{username}:{password}@{host}:{port}/{database name}?sslmode=require -``` - -[Learn more about TimescaleDB!](https://docs.timescale.com/) - -:::resources -- [Timescale DevRel: Visualize time series data with TimescaleDB and Apache Superset](https://attilatoth.dev/speaking/timescaledb-superset/) -- [Tutorial: PostgreSQL with TimescaleDB — Visualizing Real-Time Data with Superset](https://www.slingacademy.com/article/postgresql-with-timescaledb-visualizing-real-time-data-with-superset/) -::: - -#### Trino - -Supported trino version 352 and higher - -##### Connection String - -The connection string format is as follows: - -``` -trino://{username}:{password}@{hostname}:{port}/{catalog} -``` - -If you are running Trino with docker on local machine, please use the following connection URL - -``` -trino://trino@host.docker.internal:8080 -``` - -##### Authentications - -###### 1. Basic Authentication - -You can provide `username`/`password` in the connection string or in the `Secure Extra` field at `Advanced / Security` - -- In Connection String - - ``` - trino://{username}:{password}@{hostname}:{port}/{catalog} - ``` - -- In `Secure Extra` field - - ```json - { - "auth_method": "basic", - "auth_params": { - "username": "", - "password": "" - } - } - ``` - -NOTE: if both are provided, `Secure Extra` always takes higher priority. - -###### 2. Kerberos Authentication - -In `Secure Extra` field, config as following example: - -```json -{ - "auth_method": "kerberos", - "auth_params": { - "service_name": "superset", - "config": "/path/to/krb5.config", - ... - } -} -``` - -All fields in `auth_params` are passed directly to the [`KerberosAuthentication`](https://github.com/trinodb/trino-python-client/blob/0.306.0/trino/auth.py#L40) class. - -NOTE: Kerberos authentication requires installing the [`trino-python-client`](https://github.com/trinodb/trino-python-client) locally with either the `all` or `kerberos` optional features, i.e., installing `trino[all]` or `trino[kerberos]` respectively. - -###### 3. Certificate Authentication - -In `Secure Extra` field, config as following example: - -```json -{ - "auth_method": "certificate", - "auth_params": { - "cert": "/path/to/cert.pem", - "key": "/path/to/key.pem" - } -} -``` - -All fields in `auth_params` are passed directly to the [`CertificateAuthentication`](https://github.com/trinodb/trino-python-client/blob/0.315.0/trino/auth.py#L416) class. - -###### 4. JWT Authentication - -Config `auth_method` and provide token in `Secure Extra` field - -```json -{ - "auth_method": "jwt", - "auth_params": { - "token": "" - } -} -``` - -###### 5. Custom Authentication - -To use custom authentication, first you need to add it into -`ALLOWED_EXTRA_AUTHENTICATIONS` allow list in Superset config file: - -```python -from your.module import AuthClass -from another.extra import auth_method - -ALLOWED_EXTRA_AUTHENTICATIONS: Dict[str, Dict[str, Callable[..., Any]]] = { - "trino": { - "custom_auth": AuthClass, - "another_auth_method": auth_method, - }, -} -``` - -Then in `Secure Extra` field: - -```json -{ - "auth_method": "custom_auth", - "auth_params": { - ... - } -} -``` - -You can also use custom authentication by providing reference to your `trino.auth.Authentication` class -or factory function (which returns an `Authentication` instance) to `auth_method`. - -All fields in `auth_params` are passed directly to your class/function. - -:::resources -- [Starburst Docs: Superset Integration](https://docs.starburst.io/clients/superset.html) -- [Podcast: Trino and Superset](https://trino.io/episodes/12.html) -- [Blog: Trino and Apache Superset](https://preset.io/blog/2021-6-22-trino-superset/) -::: - -#### Vertica - -The recommended connector library is -[sqlalchemy-vertica-python](https://pypi.org/project/sqlalchemy-vertica-python/). The -[Vertica](http://www.vertica.com/) connection parameters are: - -- **User Name:** UserName -- **Password:** DBPassword -- **Database Host:** - - For Localhost : localhost or 127.0.0.1 - - For On Prem : IP address or Host name - - For Cloud: IP Address or Host Name -- **Database Name:** Database Name -- **Port:** default 5433 - -The connection string is formatted as follows: - -``` -vertica+vertica_python://{username}:{password}@{host}/{database} -``` - -Other parameters: - -- Load Balancer - Backup Host - -#### YDB - -The recommended connector library for [YDB](https://ydb.tech/) is -[ydb-sqlalchemy](https://pypi.org/project/ydb-sqlalchemy/). - -##### Connection String - -The connection string for YDB looks like this: - -``` -ydb://{host}:{port}/{database_name} -``` - -##### Protocol - -You can specify `protocol` in the `Secure Extra` field at `Advanced / Security`: - -``` -{ - "protocol": "grpcs" -} -``` - -Default is `grpc`. - -##### Authentication Methods - -###### Static Credentials - -To use `Static Credentials` you should provide `username`/`password` in the `Secure Extra` field at `Advanced / Security`: - -``` -{ - "credentials": { - "username": "...", - "password": "..." - } -} -``` - -###### Access Token Credentials - -To use `Access Token Credentials` you should provide `token` in the `Secure Extra` field at `Advanced / Security`: - -``` -{ - "credentials": { - "token": "...", - } -} -``` - -##### Service Account Credentials - -To use Service Account Credentials, you should provide `service_account_json` in the `Secure Extra` field at `Advanced / Security`: - -``` -{ - "credentials": { - "service_account_json": { - "id": "...", - "service_account_id": "...", - "created_at": "...", - "key_algorithm": "...", - "public_key": "...", - "private_key": "..." - } - } -} -``` - -#### YugabyteDB - -[YugabyteDB](https://www.yugabyte.com/) is a distributed SQL database built on top of PostgreSQL. - -Note that, if you're using docker compose, the -Postgres connector library [psycopg2](https://www.psycopg.org/docs/) -comes out of the box with Superset. - -The connection string looks like: - -``` -postgresql://{username}:{password}@{host}:{port}/{database} -``` - -:::resources -- [Blog: Introduction to YugabyteDB and Apache Superset](https://preset.io/blog/introduction-yugabytedb-apache-superset/) -::: - -## Connecting through the UI - -Here is the documentation on how to leverage the new DB Connection UI. This will provide admins the ability to enhance the UX for users who want to connect to new databases. - -![db-conn-docs](https://user-images.githubusercontent.com/27827808/125499607-94e300aa-1c0f-4c60-b199-3f9de41060a3.gif) - -There are now 3 steps when connecting to a database in the new UI: - -Step 1: First the admin must inform superset what engine they want to connect to. This page is powered by the `/available` endpoint which pulls on the engines currently installed in your environment, so that only supported databases are shown. - -Step 2: Next, the admin is prompted to enter database specific parameters. Depending on whether there is a dynamic form available for that specific engine, the admin will either see the new custom form or the legacy SQLAlchemy form. We currently have built dynamic forms for (Redshift, MySQL, Postgres, and BigQuery). The new form prompts the user for the parameters needed to connect (for example, username, password, host, port, etc.) and provides immediate feedback on errors. - -Step 3: Finally, once the admin has connected to their DB using the dynamic form they have the opportunity to update any optional advanced settings. - -We hope this feature will help eliminate a huge bottleneck for users to get into the application and start crafting datasets. - -##### How to setup up preferred database options and images - -We added a new configuration option where the admin can define their preferred databases, in order: - -```python -# A list of preferred databases, in order. These databases will be -# displayed prominently in the "Add Database" dialog. You should -# use the "engine_name" attribute of the corresponding DB engine spec -# in `superset/db_engine_specs/`. -PREFERRED_DATABASES: list[str] = [ - "PostgreSQL", - "Presto", - "MySQL", - "SQLite", -] -``` - -For copyright reasons the logos for each database are not distributed with Superset. - -##### Setting images - -- To set the images of your preferred database, admins must create a mapping in the `superset_text.yml` file with engine and location of the image. The image can be host locally inside your static/file directory or online (e.g. S3) - -```python -DB_IMAGES: - postgresql: "path/to/image/postgres.jpg" - bigquery: "path/to/s3bucket/bigquery.jpg" - snowflake: "path/to/image/snowflake.jpg" -``` - -##### How to add new database engines to available endpoint - -Currently the new modal supports the following databases: - -- Postgres -- Redshift -- MySQL -- BigQuery - -When the user selects a database not in this list they will see the old dialog asking for the SQLAlchemy URI. New databases can be added gradually to the new flow. In order to support the rich configuration a DB engine spec needs to have the following attributes: - -1. `parameters_schema`: a Marshmallow schema defining the parameters needed to configure the database. For Postgres this includes username, password, host, port, etc. ([see](https://github.com/apache/superset/blob/accee507c0819cd0d7bcfb5a3e1199bc81eeebf2/superset/db_engine_specs/base.py#L1309-L1320)). -2. `default_driver`: the name of the recommended driver for the DB engine spec. Many SQLAlchemy dialects support multiple drivers, but usually one is the official recommendation. For Postgres we use "psycopg2". -3. `sqlalchemy_uri_placeholder`: a string that helps the user in case they want to type the URI directly. -4. `encryption_parameters`: parameters used to build the URI when the user opts for an encrypted connection. For Postgres this is `{"sslmode": "require"}`. - -In addition, the DB engine spec must implement these class methods: - -- `build_sqlalchemy_uri(cls, parameters, encrypted_extra)`: this method receives the distinct parameters and builds the URI from them. -- `get_parameters_from_uri(cls, uri, encrypted_extra)`: this method does the opposite, extracting the parameters from a given URI. -- `validate_parameters(cls, parameters)`: this method is used for `onBlur` validation of the form. It should return a list of `SupersetError` indicating which parameters are missing, and which parameters are definitely incorrect ([example](https://github.com/apache/superset/blob/accee507c0819cd0d7bcfb5a3e1199bc81eeebf2/superset/db_engine_specs/base.py#L1404)). - -For databases like MySQL and Postgres that use the standard format of `engine+driver://user:password@host:port/dbname` all you need to do is add the `BasicParametersMixin` to the DB engine spec, and then define the parameters 2-4 (`parameters_schema` is already present in the mixin). - -For other databases you need to implement these methods yourself. The BigQuery DB engine spec is a good example of how to do that. - -### Extra Database Settings - -##### Deeper SQLAlchemy Integration - -It is possible to tweak the database connection information using the parameters exposed by -SQLAlchemy. In the **Database edit** view, you can edit the **Extra** field as a JSON blob. - -This JSON string contains extra configuration elements. The `engine_params` object gets unpacked -into the `sqlalchemy.create_engine` call, while the `metadata_params` get unpacked into the -`sqlalchemy.MetaData` call. Refer to the SQLAlchemy docs for more information. - -##### Schemas - -Databases like Postgres and Redshift use the **schema** as the logical entity on top of the -**database**. For Superset to connect to a specific schema, you can set the **schema** parameter in -the **Edit Tables** form (Sources > Tables > Edit record). - -##### External Password Store for SQLAlchemy Connections - -Superset can be configured to use an external store for database passwords. This is useful if you a -running a custom secret distribution framework and do not wish to store secrets in Superset’s meta -database. - -Example: Write a function that takes a single argument of type `sqla.engine.url` and returns the -password for the given connection string. Then set `SQLALCHEMY_CUSTOM_PASSWORD_STORE` in your config -file to point to that function. - -```python -def example_lookup_password(url): - secret = <> - return 'secret' - -SQLALCHEMY_CUSTOM_PASSWORD_STORE = example_lookup_password -``` - -A common pattern is to use environment variables to make secrets available. -`SQLALCHEMY_CUSTOM_PASSWORD_STORE` can also be used for that purpose. - -```python -def example_password_as_env_var(url): - # assuming the uri looks like - # mysql://localhost?superset_user:{SUPERSET_PASSWORD} - return url.password.format(**os.environ) - -SQLALCHEMY_CUSTOM_PASSWORD_STORE = example_password_as_env_var -``` - -##### SSL Access to Databases - -You can use the `Extra` field in the **Edit Databases** form to configure SSL: - -```JSON -{ - "metadata_params": {}, - "engine_params": { - "connect_args":{ - "sslmode":"require", - "sslrootcert": "/path/to/my/pem" - } - } -} -``` -##### Custom Error Messages -You can use the `CUSTOM_DATABASE_ERRORS` in the `superset/custom_database_errors.py` file or overwrite it in your config file to configure custom error messages for database exceptions. - -This feature lets you transform raw database errors into user-friendly messages, optionally including documentation links and hiding default error codes. - -Provide an empty string as the first value to keep the original error message. This way, you can add just a link to the documentation -**Example usage:** -```Python -CUSTOM_DATABASE_ERRORS = { - "database_name": { - re.compile('permission denied for view'): ( - __( - 'Permission denied' - ), - SupersetErrorType.GENERIC_DB_ENGINE_ERROR, - { - "custom_doc_links": [ - { - "url": "https://example.com/docs/1", - "label": "Check documentation" - }, - ], - "show_issue_info": False, - } - ) - }, - "examples": { - re.compile(r'message="(?P[^"]*)"'): ( - __( - 'Unexpected error: "%(message)s"' - ), - SupersetErrorType.GENERIC_DB_ENGINE_ERROR, - {} - ) - } -} -``` - -**Options:** - -- ``custom_doc_links``: List of documentation links to display with the error. -- ``show_issue_info``: Set to ``False`` to hide default error codes. - -## Misc - -### Querying across databases - -Superset offers an experimental feature for querying across different databases. This is done via a special database called "Superset meta database" that uses the "superset://" SQLAlchemy URI. When using the database it's possible to query any table in any of the configured databases using the following syntax: - -```sql -SELECT * FROM "database name.[[catalog.].schema].table name"; -``` - -For example: - -```sql -SELECT * FROM "examples.birth_names"; -``` - -Spaces are allowed, but periods in the names must be replaced by `%2E`. Eg: - -```sql -SELECT * FROM "Superset meta database.examples%2Ebirth_names"; -``` - -The query above returns the same rows as `SELECT * FROM "examples.birth_names"`, and also shows that the meta database can query tables from any table — even itself! - -#### Considerations - -Before enabling this feature, there are a few considerations that you should have in mind. First, the meta database enforces permissions on the queried tables, so users should only have access via the database to tables that they originally have access to. Nevertheless, the meta database is a new surface for potential attacks, and bugs could allow users to see data they should not. - -Second, there are performance considerations. The meta database will push any filtering, sorting, and limiting to the underlying databases, but any aggregations and joins will happen in memory in the process running the query. Because of this, it's recommended to run the database in async mode, so queries are executed in Celery workers, instead of the web workers. Additionally, it's possible to specify a hard limit on how many rows are returned from the underlying databases. - -#### Enabling the meta database - -To enable the Superset meta database, first you need to set the `ENABLE_SUPERSET_META_DB` feature flag to true. Then, add a new database of type "Superset meta database" with the SQLAlchemy URI "superset://". - -If you enable DML in the meta database users will be able to run DML queries on underlying databases **as long as DML is also enabled in them**. This allows users to run queries that move data across databases. - -Second, you might want to change the value of `SUPERSET_META_DB_LIMIT`. The default value is 1000, and defines how many are read from each database before any aggregations and joins are executed. You can also set this value `None` if you only have small tables. - -Additionally, you might want to restrict the databases to with the meta database has access to. This can be done in the database configuration, under "Advanced" -> "Other" -> "ENGINE PARAMETERS" and adding: - -```json -{"allowed_dbs":["Google Sheets","examples"]} -``` diff --git a/docs/docs/configuration/feature-flags.mdx b/docs/docs/configuration/feature-flags.mdx new file mode 100644 index 00000000000..b573b07d326 --- /dev/null +++ b/docs/docs/configuration/feature-flags.mdx @@ -0,0 +1,107 @@ +--- +title: Feature Flags +hide_title: true +sidebar_position: 2 +version: 1 +--- + +import featureFlags from '@site/static/feature-flags.json'; + +export const FlagTable = ({flags}) => ( + + + + + + + + + + {flags.map((flag) => ( + + + + + + ))} + +
FlagDefaultDescription
{flag.name}{flag.default ? 'True' : 'False'} + {flag.description} + {flag.docs && ( + <> (docs) + )} +
+); + +# Feature Flags + +Superset uses feature flags to control the availability of features. Feature flags allow +gradual rollout of new functionality and provide a way to enable experimental features. + +To enable a feature flag, add it to your `superset_config.py`: + +```python +FEATURE_FLAGS = { + "ENABLE_TEMPLATE_PROCESSING": True, +} +``` + +## Lifecycle + +Feature flags progress through lifecycle stages: + +| Stage | Description | +|-------|-------------| +| **Development** | Experimental features under active development. May be incomplete or unstable. | +| **Testing** | Feature complete but undergoing testing. Usable but may contain bugs. | +| **Stable** | Production-ready features. Safe for all deployments. | +| **Deprecated** | Features scheduled for removal. Migrate away from these. | + +--- + +## Development + +These features are experimental and under active development. Use only in development environments. + + + +--- + +## Testing + +These features are complete but still being tested. They are usable but may have bugs. + + + +--- + +## Stable + +These features are production-ready and safe to enable. + + + +--- + +## Deprecated + +These features are scheduled for removal. Plan to migrate away from them. + + + +--- + +## Adding New Feature Flags + +When adding a new feature flag to `superset/config.py`, include the following annotations: + +```python +# Description of what the feature does +# @lifecycle: development | testing | stable | deprecated +# @docs: https://superset.apache.org/docs/... (optional) +# @category: runtime_config | path_to_deprecation (optional, for stable flags) +"MY_NEW_FEATURE": False, +``` + +This documentation is auto-generated from the annotations in +[config.py](https://github.com/apache/superset/blob/master/superset/config.py). diff --git a/docs/docs/configuration/networking-settings.mdx b/docs/docs/configuration/networking-settings.mdx index 49caf55d6a7..74f13ff7986 100644 --- a/docs/docs/configuration/networking-settings.mdx +++ b/docs/docs/configuration/networking-settings.mdx @@ -60,7 +60,7 @@ There are two approaches to making dashboards publicly accessible: **Option 2: Dashboard-level access (selective control)** 1. Set `PUBLIC_ROLE_LIKE = "Public"` in `superset_config.py` -2. Add the `'DASHBOARD_RBAC': True` [Feature Flag](https://github.com/apache/superset/blob/master/RESOURCES/FEATURE_FLAGS.md) +2. Add the `'DASHBOARD_RBAC': True` [Feature Flag](/docs/configuration/feature-flags) 3. Edit each dashboard's properties and add the "Public" role 4. Only dashboards with the Public role explicitly assigned are visible to anonymous users diff --git a/docs/docs/configuration/timezones.mdx b/docs/docs/configuration/timezones.mdx index 233e4786fcd..a1289d1cb9c 100644 --- a/docs/docs/configuration/timezones.mdx +++ b/docs/docs/configuration/timezones.mdx @@ -20,7 +20,7 @@ To help make the problem somewhat tractable—given that Apache Superset has no To strive for data consistency (regardless of the timezone of the client) the Apache Superset backend tries to ensure that any timestamp sent to the client has an explicit (or semi-explicit as in the case with [Epoch time](https://en.wikipedia.org/wiki/Unix_time) which is always in reference to UTC) timezone encoded within. -The challenge however lies with the slew of [database engines](/docs/configuration/databases#installing-drivers-in-docker-images) which Apache Superset supports and various inconsistencies between their [Python Database API (DB-API)](https://www.python.org/dev/peps/pep-0249/) implementations combined with the fact that we use [Pandas](https://pandas.pydata.org/) to read SQL into a DataFrame prior to serializing to JSON. Regrettably Pandas ignores the DB-API [type_code](https://www.python.org/dev/peps/pep-0249/#type-objects) relying by default on the underlying Python type returned by the DB-API. Currently only a subset of the supported database engines work correctly with Pandas, i.e., ensuring timestamps without an explicit timestamp are serializd to JSON with the server timezone, thus guaranteeing the client will display timestamps in a consistent manner irrespective of the client's timezone. +The challenge however lies with the slew of [database engines](/docs/databases#installing-drivers-in-docker) which Apache Superset supports and various inconsistencies between their [Python Database API (DB-API)](https://www.python.org/dev/peps/pep-0249/) implementations combined with the fact that we use [Pandas](https://pandas.pydata.org/) to read SQL into a DataFrame prior to serializing to JSON. Regrettably Pandas ignores the DB-API [type_code](https://www.python.org/dev/peps/pep-0249/#type-objects) relying by default on the underlying Python type returned by the DB-API. Currently only a subset of the supported database engines work correctly with Pandas, i.e., ensuring timestamps without an explicit timestamp are serializd to JSON with the server timezone, thus guaranteeing the client will display timestamps in a consistent manner irrespective of the client's timezone. For example the following is a comparison of MySQL and Presto, diff --git a/docs/docs/contributing/development.mdx b/docs/docs/contributing/development.mdx index 09e9fdc1f93..b75f2d5118a 100644 --- a/docs/docs/contributing/development.mdx +++ b/docs/docs/contributing/development.mdx @@ -350,6 +350,12 @@ superset init # Note: you MUST have previously created an admin user with the username `admin` for this command to work. superset load-examples +# The load-examples command supports various options: +# --force / -f Force reload data even if tables exist +# --only-metadata / -m Only create table metadata without loading data (fast setup) +# --load-test-data / -t Load additional test dashboards and datasets +# --load-big-data / -b Generate synthetic data for stress testing (wide tables, many tables) + # Start the Flask dev web server from inside your virtualenv. # Note that your page may not have CSS at this point. # See instructions below on how to build the front-end assets. @@ -599,7 +605,7 @@ export enum FeatureFlag { those specified under FEATURE_FLAGS in `superset_config.py`. For example, `DEFAULT_FEATURE_FLAGS = { 'FOO': True, 'BAR': False }` in `superset/config.py` and `FEATURE_FLAGS = { 'BAR': True, 'BAZ': True }` in `superset_config.py` will result in combined feature flags of `{ 'FOO': True, 'BAR': True, 'BAZ': True }`. -The current status of the usability of each flag (stable vs testing, etc) can be found in `RESOURCES/FEATURE_FLAGS.md`. +The current status of the usability of each flag (stable vs testing, etc) can be found in the [Feature Flags](/docs/configuration/feature-flags) documentation. ## Git Hooks @@ -692,6 +698,97 @@ secrets. --- +## Example Data and Test Loaders + +### Example Datasets + +Superset includes example datasets stored as Parquet files, organized by example name in the `superset/examples/` directory. Each example is self-contained: + +``` +superset/examples/ +├── _shared/ # Shared configuration +│ ├── database.yaml # Database connection config +│ └── metadata.yaml # Import metadata +├── birth_names/ # Example: US Birth Names +│ ├── data.parquet # Dataset (compressed columnar) +│ ├── dataset.yaml # Dataset metadata +│ ├── dashboard.yaml # Dashboard configuration (optional) +│ └── charts/ # Chart configurations (optional) +│ ├── Boys.yaml +│ ├── Girls.yaml +│ └── ... +├── energy_usage/ # Example: Energy Sankey +│ ├── data.parquet +│ ├── dataset.yaml +│ └── charts/ +└── ... (27 example directories) +``` + +#### Adding a New Example Dataset + +**Simple dataset (data only):** + +1. Create a directory: `superset/examples/my_dataset/` +2. Add your data as `data.parquet`: + ```python + import pandas as pd + df = pd.read_csv("your_data.csv") + df.to_parquet("superset/examples/my_dataset/data.parquet", compression="snappy") + ``` +3. The dataset will be auto-discovered when running `superset load-examples` + +**Complete example with dashboard:** + +1. Create your dataset directory with `data.parquet` +2. Add `dataset.yaml` with metadata (columns, metrics, etc.) +3. Add `dashboard.yaml` with dashboard layout +4. Add chart configs in `charts/` directory +5. See existing examples like `birth_names/` for reference + +#### Exporting an Existing Dashboard + +To export a dashboard and its charts as YAML configs: + +1. In Superset, go to the dashboard you want to export +2. Click the "..." menu → "Export" +3. Unzip the exported file +4. Copy the YAML files to your example directory +5. Add the `data.parquet` file + +#### Why Parquet? + +- **Apache-friendly**: Parquet is an Apache project, ideal for ASF codebases +- **Compressed**: Built-in Snappy compression (~27% smaller than CSV) +- **Self-describing**: Schema is embedded in the file +- **Widely supported**: Works with pandas, pyarrow, DuckDB, Spark, etc. + +### Test Data Generation + +For stress testing and development, Superset includes special test data generators that create synthetic data: + +#### Big Data Loader (`--load-big-data`) + +Located in `superset/cli/test_loaders.py`, this generates: + +- **Wide Table** (`wide_table`): 100 columns of mixed types, 1000 rows +- **Many Small Tables** (`small_table_0` through `small_table_999`): 1000 tables for testing catalog performance +- **Long Name Table**: Table with 60-character random name for testing UI edge cases + +This is primarily used for: +- Performance testing with extreme data shapes +- UI edge case validation +- Database catalog stress testing +- CI/CD pipeline validation + +#### Test Dashboards (`--load-test-data`) + +Loads additional test-specific content: +- Tabbed dashboard example +- Supported charts dashboard +- Test configuration files (*.test.yaml) + +--- + ## Testing ### Python Testing diff --git a/docs/docs/faq.mdx b/docs/docs/faq.mdx index d168eacde24..154d668b4e6 100644 --- a/docs/docs/faq.mdx +++ b/docs/docs/faq.mdx @@ -157,7 +157,7 @@ table afterwards to configure the Columns tab, check the appropriate boxes and s To clarify, the database backend is an OLTP database used by Superset to store its internal information like your list of users and dashboard definitions. While Superset supports a -[variety of databases as data _sources_](/docs/configuration/databases#installing-database-drivers), +[variety of databases as data _sources_](/docs/databases#installing-database-drivers), only a few database engines are supported for use as the OLTP backend / metadata store. Superset is tested using MySQL, PostgreSQL, and SQLite backends. It’s recommended you install @@ -190,7 +190,7 @@ second etc). Example: ## Does Superset work with [insert database engine here]? -The [Connecting to Databases section](/docs/configuration/databases) provides the best +The [Connecting to Databases section](/docs/databases) provides the best overview for supported databases. Database engines not listed on that page may work too. We rely on the community to contribute to this knowledge base. diff --git a/docs/docs/installation/kubernetes.mdx b/docs/docs/installation/kubernetes.mdx index 06e5991b591..cf8e0542a67 100644 --- a/docs/docs/installation/kubernetes.mdx +++ b/docs/docs/installation/kubernetes.mdx @@ -149,7 +149,7 @@ For production clusters it's recommended to build own image with this step done Superset requires a Python DB-API database driver and a SQLAlchemy dialect to be installed for each datastore you want to connect to. -See [Install Database Drivers](/docs/configuration/databases) for more information. +See [Install Database Drivers](/docs/databases#installing-database-drivers) for more information. It is recommended that you refer to versions listed in [pyproject.toml](https://github.com/apache/superset/blob/master/pyproject.toml) instead of hard-coding them in your bootstrap script, as seen below. diff --git a/docs/docs/installation/upgrading-superset.mdx b/docs/docs/installation/upgrading-superset.mdx index 46f00b0616b..0cf092a5a06 100644 --- a/docs/docs/installation/upgrading-superset.mdx +++ b/docs/docs/installation/upgrading-superset.mdx @@ -47,3 +47,15 @@ superset init While upgrading superset should not delete your charts and dashboards, we recommend following best practices and to backup your metadata database before upgrading. Before upgrading production, we recommend upgrading in a staging environment and upgrading production finally during off-peak usage. + +## Breaking Changes + +For a detailed list of breaking changes and migration notes for each version, see +[UPDATING.md](https://github.com/apache/superset/blob/master/UPDATING.md). + +This file documents backwards-incompatible changes and provides guidance for migrating between +major versions, including: +- Configuration changes +- API changes +- Database migrations +- Deprecated features diff --git a/docs/docs/quickstart.mdx b/docs/docs/quickstart.mdx index 8bc03df3680..b92c038fb22 100644 --- a/docs/docs/quickstart.mdx +++ b/docs/docs/quickstart.mdx @@ -74,7 +74,7 @@ processes by running Docker Compose `stop` command. By doing so, you can avoid d From this point on, you can head on to: - [Create your first Dashboard](/docs/using-superset/creating-your-first-dashboard) -- [Connect to a Database](/docs/configuration/databases) +- [Connect to a Database](/docs/databases) - [Using Docker Compose](/docs/installation/docker-compose) - [Configure Superset](/docs/configuration/configuring-superset/) - [Installing on Kubernetes](/docs/installation/kubernetes/) diff --git a/docs/docusaurus.config.ts b/docs/docusaurus.config.ts index cfb4121457c..9b5e2feb04b 100644 --- a/docs/docusaurus.config.ts +++ b/docs/docusaurus.config.ts @@ -134,7 +134,7 @@ if (!versionsConfig.developer_portal.disabled && !versionsConfig.developer_porta { type: 'doc', docsPluginId: 'developer_portal', - docId: 'extensions/architectural-principles', + docId: 'extensions/overview', label: 'Extensions', }, { @@ -222,7 +222,7 @@ const config: Config = { from: '/gallery.html', }, { - to: '/docs/configuration/databases', + to: '/docs/databases', from: '/druid.html', }, { @@ -274,7 +274,7 @@ const config: Config = { from: '/docs/contributing/contribution-page', }, { - to: '/docs/configuration/databases', + to: '/docs/databases', from: '/docs/databases/yugabyte/', }, { @@ -410,6 +410,11 @@ const config: Config = { docId: 'intro', label: 'Getting Started', }, + { + type: 'doc', + docId: 'databases/index', + label: 'Databases', + }, { type: 'doc', docId: 'faq', @@ -468,8 +473,10 @@ const config: Config = { footer: { links: [], copyright: ` -
- We use   +
+ CI powered by + Applitools + Netlify

Copyright © ${new Date().getFullYear()}, The Apache Software Foundation, diff --git a/docs/i18n/en/docusaurus-theme-classic/footer.json b/docs/i18n/en/docusaurus-theme-classic/footer.json index 4602bfa823c..ba6d9b1bc93 100644 --- a/docs/i18n/en/docusaurus-theme-classic/footer.json +++ b/docs/i18n/en/docusaurus-theme-classic/footer.json @@ -1,6 +1,6 @@ { "copyright": { - "message": "\n

\n We use  \n
\n

Copyright © 2024,\n The Apache Software Foundation,\n Licensed under the Apache License.

\n

Apache Superset, Apache, Superset, the Superset logo, and the Apache feather logo are either registered trademarks or trademarks of The Apache Software Foundation. All other products or name brands are trademarks of their respective holders, including The Apache Software Foundation.\n Apache Software Foundation resources

\n \"Divider\"\n

\n \n Security | \n Donate | \n Thanks | \n Events | \n License | \n Privacy\n \n

\n \n \n ", + "message": "\n
\n CI powered by\n \"Applitools\"\n \"Netlify\"\n
\n

Copyright © 2026,\n The Apache Software Foundation,\n Licensed under the Apache License.

\n

Apache Superset, Apache, Superset, the Superset logo, and the Apache feather logo are either registered trademarks or trademarks of The Apache Software Foundation. All other products or name brands are trademarks of their respective holders, including The Apache Software Foundation.\n Apache Software Foundation resources

\n \"Divider\"\n

\n \n Security | \n Donate | \n Thanks | \n Events | \n License | \n Privacy\n \n

\n \n \n ", "description": "The footer copyright" } } diff --git a/docs/package.json b/docs/package.json index 8d3d6d15998..ee68295c211 100644 --- a/docs/package.json +++ b/docs/package.json @@ -6,17 +6,22 @@ "scripts": { "docusaurus": "docusaurus", "_init": "cat src/intro_header.txt ../README.md > docs/intro.md", - "start": "yarn run _init && yarn run generate:extension-components && NODE_ENV=development docusaurus start", + "start": "yarn run _init && yarn run generate:extension-components && yarn run generate:database-docs && NODE_ENV=development docusaurus start", "stop": "pkill -f 'docusaurus start' || pkill -f 'docusaurus serve' || echo 'No docusaurus server running'", - "build": "yarn run _init && yarn run generate:extension-components && DEBUG=docusaurus:* docusaurus build", + "build": "yarn run _init && yarn run generate:extension-components && yarn run generate:database-docs && DEBUG=docusaurus:* docusaurus build", "swizzle": "docusaurus swizzle", "deploy": "docusaurus deploy", "clear": "docusaurus clear", "serve": "yarn run _init && docusaurus serve", "write-translations": "docusaurus write-translations", "write-heading-ids": "docusaurus write-heading-ids", - "typecheck": "yarn run generate:extension-components && tsc", + "typecheck": "yarn run generate:extension-components && yarn run generate:database-docs && tsc", "generate:extension-components": "node scripts/generate-extension-components.mjs", + "generate:database-docs": "node scripts/generate-database-docs.mjs", + "gen-db-docs": "node scripts/generate-database-docs.mjs", + "lint:db-metadata": "python3 ../superset/db_engine_specs/lint_metadata.py", + "lint:db-metadata:report": "python3 ../superset/db_engine_specs/lint_metadata.py --markdown -o ../superset/db_engine_specs/METADATA_STATUS.md", + "update:readme-db-logos": "node scripts/generate-database-docs.mjs --update-readme", "eslint": "eslint .", "version:add": "node scripts/manage-versions.mjs add", "version:remove": "node scripts/manage-versions.mjs remove", @@ -51,8 +56,8 @@ "@storybook/preview-api": "^8.6.11", "@storybook/theming": "^8.6.11", "@superset-ui/core": "^0.20.4", - "antd": "^6.2.0", - "caniuse-lite": "^1.0.30001764", + "antd": "^6.2.2", + "caniuse-lite": "^1.0.30001766", "docusaurus-plugin-less": "^2.0.2", "js-yaml": "^4.1.1", "js-yaml-loader": "^1.2.2", @@ -70,7 +75,7 @@ "swagger-ui-react": "^5.31.0", "tinycolor2": "^1.4.2", "ts-loader": "^9.5.4", - "unist-util-visit": "^5.0.0" + "unist-util-visit": "^5.1.0" }, "devDependencies": { "@docusaurus/module-type-aliases": "^3.9.1", @@ -84,10 +89,10 @@ "eslint-config-prettier": "^10.1.8", "eslint-plugin-prettier": "^5.5.5", "eslint-plugin-react": "^7.37.5", - "globals": "^17.0.0", - "prettier": "^3.8.0", + "globals": "^17.1.0", + "prettier": "^3.8.1", "typescript": "~5.9.3", - "typescript-eslint": "^8.53.0", + "typescript-eslint": "^8.54.0", "webpack": "^5.104.1" }, "browserslist": { diff --git a/docs/scripts/extract_custom_errors.py b/docs/scripts/extract_custom_errors.py new file mode 100644 index 00000000000..35aee1cdbc2 --- /dev/null +++ b/docs/scripts/extract_custom_errors.py @@ -0,0 +1,296 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. + +""" +Extract custom_errors from database engine specs for documentation. + +This script parses engine spec files to extract error handling information +that can be displayed on database documentation pages. + +Usage: python scripts/extract_custom_errors.py +Output: JSON mapping of engine spec module names to their custom errors +""" + +import ast +import json # noqa: TID251 - standalone docs script, not part of superset +import sys +from pathlib import Path +from typing import Any + +# Map SupersetErrorType values to human-readable categories and issue codes +ERROR_TYPE_INFO = { + "CONNECTION_INVALID_USERNAME_ERROR": { + "category": "Authentication", + "description": "Invalid username", + "issue_codes": [1012], + }, + "CONNECTION_INVALID_PASSWORD_ERROR": { + "category": "Authentication", + "description": "Invalid password", + "issue_codes": [1013], + }, + "CONNECTION_ACCESS_DENIED_ERROR": { + "category": "Authentication", + "description": "Access denied", + "issue_codes": [1014, 1015], + }, + "CONNECTION_INVALID_HOSTNAME_ERROR": { + "category": "Connection", + "description": "Invalid hostname", + "issue_codes": [1007], + }, + "CONNECTION_PORT_CLOSED_ERROR": { + "category": "Connection", + "description": "Port closed or refused", + "issue_codes": [1008], + }, + "CONNECTION_HOST_DOWN_ERROR": { + "category": "Connection", + "description": "Host unreachable", + "issue_codes": [1009], + }, + "CONNECTION_UNKNOWN_DATABASE_ERROR": { + "category": "Connection", + "description": "Unknown database", + "issue_codes": [1015], + }, + "CONNECTION_DATABASE_PERMISSIONS_ERROR": { + "category": "Permissions", + "description": "Insufficient permissions", + "issue_codes": [1017], + }, + "CONNECTION_MISSING_PARAMETERS_ERROR": { + "category": "Configuration", + "description": "Missing parameters", + "issue_codes": [1018], + }, + "CONNECTION_DATABASE_TIMEOUT": { + "category": "Connection", + "description": "Connection timeout", + "issue_codes": [1001, 1009], + }, + "COLUMN_DOES_NOT_EXIST_ERROR": { + "category": "Query", + "description": "Column not found", + "issue_codes": [1003, 1004], + }, + "TABLE_DOES_NOT_EXIST_ERROR": { + "category": "Query", + "description": "Table not found", + "issue_codes": [1003, 1005], + }, + "SCHEMA_DOES_NOT_EXIST_ERROR": { + "category": "Query", + "description": "Schema not found", + "issue_codes": [1003, 1016], + }, + "SYNTAX_ERROR": { + "category": "Query", + "description": "SQL syntax error", + "issue_codes": [1030], + }, + "OBJECT_DOES_NOT_EXIST_ERROR": { + "category": "Query", + "description": "Object not found", + "issue_codes": [1029], + }, + "GENERIC_DB_ENGINE_ERROR": { + "category": "General", + "description": "Database engine error", + "issue_codes": [1002], + }, +} + + +def extract_string_from_call(node: ast.Call) -> str | None: + """Extract string from __() or _() translation calls.""" + if not node.args: + return None + arg = node.args[0] + if isinstance(arg, ast.Constant) and isinstance(arg.value, str): + return arg.value + elif isinstance(arg, ast.JoinedStr): + # f-string - try to reconstruct + parts = [] + for value in arg.values: + if isinstance(value, ast.Constant): + parts.append(str(value.value)) + elif isinstance(value, ast.FormattedValue): + # Just use a placeholder + parts.append("{...}") + return "".join(parts) + return None + + +def extract_custom_errors_from_file(filepath: Path) -> dict[str, list[dict[str, Any]]]: + """ + Extract custom_errors definitions from a Python engine spec file. + + Returns a dict mapping class names to their custom errors list. + """ + results = {} + + try: + with open(filepath, "r", encoding="utf-8") as f: + source = f.read() + + tree = ast.parse(source) + + for node in ast.walk(tree): + if isinstance(node, ast.ClassDef): + class_name = node.name + + for item in node.body: + # Look for custom_errors = { ... } + if ( + isinstance(item, ast.AnnAssign) + and isinstance(item.target, ast.Name) + and item.target.id == "custom_errors" + and isinstance(item.value, ast.Dict) + ): + errors = extract_errors_from_dict(item.value, source) + if errors: + results[class_name] = errors + + # Also handle simple assignment: custom_errors = { ... } + elif ( + isinstance(item, ast.Assign) + and len(item.targets) == 1 + and isinstance(item.targets[0], ast.Name) + and item.targets[0].id == "custom_errors" + and isinstance(item.value, ast.Dict) + ): + errors = extract_errors_from_dict(item.value, source) + if errors: + results[class_name] = errors + + except (OSError, SyntaxError, ValueError) as e: + print(f"Error parsing {filepath}: {e}", file=sys.stderr) + + return results + + +def extract_regex_info(key: ast.expr) -> dict[str, Any]: + """Extract regex pattern info from the dict key.""" + if isinstance(key, ast.Name): + return {"regex_name": key.id} + if isinstance(key, ast.Call): + if ( + isinstance(key.func, ast.Attribute) + and key.func.attr == "compile" + and key.args + and isinstance(key.args[0], ast.Constant) + ): + return {"regex_pattern": key.args[0].value} + return {} + + +def extract_invalid_fields(extra_node: ast.Dict) -> list[str]: + """Extract invalid fields from the extra dict.""" + for k, v in zip(extra_node.keys, extra_node.values, strict=False): + if ( + isinstance(k, ast.Constant) + and k.value == "invalid" + and isinstance(v, ast.List) + ): + return [elem.value for elem in v.elts if isinstance(elem, ast.Constant)] + return [] + + +def extract_error_tuple_info(value: ast.Tuple) -> dict[str, Any]: + """Extract error info from the (message, error_type, extra) tuple.""" + result: dict[str, Any] = {} + + # First element: message template + msg_node = value.elts[0] + if isinstance(msg_node, ast.Call): + message = extract_string_from_call(msg_node) + if message: + result["message_template"] = message + elif isinstance(msg_node, ast.Constant): + result["message_template"] = msg_node.value + + # Second element: SupersetErrorType.SOMETHING + type_node = value.elts[1] + if isinstance(type_node, ast.Attribute): + error_type = type_node.attr + result["error_type"] = error_type + if error_type in ERROR_TYPE_INFO: + type_info = ERROR_TYPE_INFO[error_type] + result["category"] = type_info["category"] + result["description"] = type_info["description"] + result["issue_codes"] = type_info["issue_codes"] + + # Third element: extra dict with invalid fields + if len(value.elts) >= 3 and isinstance(value.elts[2], ast.Dict): + invalid_fields = extract_invalid_fields(value.elts[2]) + if invalid_fields: + result["invalid_fields"] = invalid_fields + + return result + + +def extract_errors_from_dict(dict_node: ast.Dict, source: str) -> list[dict[str, Any]]: + """Extract error information from a custom_errors dict AST node.""" + errors = [] + + for key, value in zip(dict_node.keys, dict_node.values, strict=False): + if key is None or value is None: + continue + + error_info = extract_regex_info(key) + + if isinstance(value, ast.Tuple) and len(value.elts) >= 2: + error_info.update(extract_error_tuple_info(value)) + + if error_info.get("error_type") and error_info.get("message_template"): + errors.append(error_info) + + return errors + + +def main() -> None: + """Main function to extract custom_errors from all engine specs.""" + # Find the superset root directory + script_dir = Path(__file__).parent + root_dir = script_dir.parent.parent + specs_dir = root_dir / "superset" / "db_engine_specs" + + if not specs_dir.exists(): + print(f"Error: Engine specs directory not found: {specs_dir}", file=sys.stderr) + sys.exit(1) + + all_errors = {} + + # Process each Python file in the specs directory + for filepath in sorted(specs_dir.glob("*.py")): + if filepath.name.startswith("_"): + continue + + module_name = filepath.stem + class_errors = extract_custom_errors_from_file(filepath) + + if class_errors: + # Store errors by module and class + all_errors[module_name] = class_errors + + # Output as JSON + print(json.dumps(all_errors, indent=2)) + + +if __name__ == "__main__": + main() diff --git a/docs/scripts/generate-database-docs.mjs b/docs/scripts/generate-database-docs.mjs new file mode 100644 index 00000000000..04980f24f83 --- /dev/null +++ b/docs/scripts/generate-database-docs.mjs @@ -0,0 +1,943 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, + * software distributed under the License is distributed on an + * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + * KIND, either express or implied. See the License for the + * specific language governing permissions and limitations + * under the License. + */ + +/** + * This script generates database documentation data from engine spec metadata. + * It outputs a JSON file that can be imported by React components for rendering. + * + * Usage: node scripts/generate-database-docs.mjs + * + * The script can run in two modes: + * 1. With Flask app (full diagnostics) - requires superset to be installed + * 2. Fallback mode (documentation only) - parses engine spec `metadata` attributes via AST + */ + +import { spawnSync } from 'child_process'; +import fs from 'fs'; +import path from 'path'; +import { fileURLToPath } from 'url'; + +const __filename = fileURLToPath(import.meta.url); +const __dirname = path.dirname(__filename); +const ROOT_DIR = path.resolve(__dirname, '../..'); +const DOCS_DIR = path.resolve(__dirname, '..'); +const DATA_OUTPUT_DIR = path.join(DOCS_DIR, 'src/data'); +const DATA_OUTPUT_FILE = path.join(DATA_OUTPUT_DIR, 'databases.json'); +const MDX_OUTPUT_DIR = path.join(DOCS_DIR, 'docs/databases'); +const MDX_SUPPORTED_DIR = path.join(MDX_OUTPUT_DIR, 'supported'); + +/** + * Try to run the full lib.py script with Flask context + */ +function tryRunFullScript() { + try { + console.log('Attempting to run lib.py with Flask context...'); + const pythonCode = ` +import sys +import json +sys.path.insert(0, '.') +from superset.app import create_app +from superset.db_engine_specs.lib import generate_yaml_docs +app = create_app() +with app.app_context(): + docs = generate_yaml_docs() + print(json.dumps(docs, default=str)) +`; + const result = spawnSync('python', ['-c', pythonCode], { + cwd: ROOT_DIR, + encoding: 'utf-8', + timeout: 60000, + maxBuffer: 10 * 1024 * 1024, + env: { ...process.env, SUPERSET_SECRET_KEY: 'docs-build-key' }, + }); + + if (result.error) { + throw result.error; + } + if (result.status !== 0) { + throw new Error(result.stderr || 'Python script failed'); + } + return JSON.parse(result.stdout); + } catch (error) { + console.log('Full script execution failed, using fallback mode...'); + console.log(' Reason:', error.message?.split('\n')[0] || 'Unknown error'); + return null; + } +} + +/** + * Extract metadata from individual engine spec files using AST parsing + * This is the preferred approach - reads directly from spec.metadata attributes + * Supports metadata inheritance - child classes inherit and merge with parent metadata + */ +function extractEngineSpecMetadata() { + console.log('Extracting metadata from engine spec files...'); + console.log(` ROOT_DIR: ${ROOT_DIR}`); + + try { + const pythonCode = ` +import sys +import json +import ast +import os + +def eval_node(node): + """Safely evaluate an AST node as a Python literal.""" + if node is None: + return None + if isinstance(node, ast.Constant): + return node.value + elif isinstance(node, ast.List): + return [eval_node(e) for e in node.elts] + elif isinstance(node, ast.Dict): + result = {} + for k, v in zip(node.keys, node.values): + if k is not None: + key = eval_node(k) + if key is not None: + result[key] = eval_node(v) + return result + elif isinstance(node, ast.Name): + # Handle True, False, None constants + if node.id == 'True': + return True + elif node.id == 'False': + return False + elif node.id == 'None': + return None + return node.id + elif isinstance(node, ast.Attribute): + # Handle DatabaseCategory.SOMETHING - return just the attribute name + return node.attr + elif isinstance(node, ast.BinOp) and isinstance(node.op, ast.Add): + left, right = eval_node(node.left), eval_node(node.right) + if isinstance(left, str) and isinstance(right, str): + return left + right + return None + elif isinstance(node, ast.Tuple): + return tuple(eval_node(e) for e in node.elts) + elif isinstance(node, ast.JoinedStr): + # f-strings - just return a placeholder + return "" + return None + +def deep_merge(base, override): + """Deep merge two dictionaries. Override values take precedence.""" + if base is None: + return override + if override is None: + return base + if not isinstance(base, dict) or not isinstance(override, dict): + return override + + # Fields that should NOT be inherited from parent classes + # - compatible_databases: Each class defines its own compatible DBs + # - categories: Each class defines its own categories (not extended from parent) + NON_INHERITABLE_FIELDS = {'compatible_databases', 'categories'} + + result = base.copy() + # Remove non-inheritable fields from base (they should only come from the class that defines them) + for field in NON_INHERITABLE_FIELDS: + result.pop(field, None) + + for key, value in override.items(): + if key in result and isinstance(result[key], dict) and isinstance(value, dict): + result[key] = deep_merge(result[key], value) + elif key in result and isinstance(result[key], list) and isinstance(value, list): + # Extend lists from parent (e.g., drivers) + result[key] = result[key] + value + else: + result[key] = value + return result + +databases = {} +specs_dir = 'superset/db_engine_specs' +errors = [] +debug_info = { + "cwd": os.getcwd(), + "specs_dir_exists": os.path.isdir(specs_dir), + "files_checked": 0, + "classes_found": 0, + "classes_with_metadata": 0, + "inherited_metadata": 0, +} + +if not os.path.isdir(specs_dir): + print(json.dumps({"error": f"Directory not found: {specs_dir}", "cwd": os.getcwd()})) + sys.exit(1) + +# First pass: collect all class info (name, bases, metadata) +class_info = {} # class_name -> {bases: [], metadata: {}, engine_name: str, filename: str} + +for filename in sorted(os.listdir(specs_dir)): + if not filename.endswith('.py') or filename in ('__init__.py', 'lib.py', 'lint_metadata.py'): + continue + + debug_info["files_checked"] += 1 + filepath = os.path.join(specs_dir, filename) + try: + with open(filepath) as f: + source = f.read() + tree = ast.parse(source) + + for node in ast.walk(tree): + if not isinstance(node, ast.ClassDef): + continue + + # Get base class names + base_names = [] + for b in node.bases: + if isinstance(b, ast.Name): + base_names.append(b.id) + elif isinstance(b, ast.Attribute): + base_names.append(b.attr) + + is_engine_spec = any('EngineSpec' in name or 'Mixin' in name for name in base_names) + if not is_engine_spec: + continue + + # Extract class attributes + engine_name = None + metadata = None + + for item in node.body: + if isinstance(item, ast.Assign): + for target in item.targets: + if isinstance(target, ast.Name): + if target.id == 'engine_name': + val = eval_node(item.value) + if isinstance(val, str): + engine_name = val + elif target.id == 'metadata': + metadata = eval_node(item.value) + + # Check for engine attribute with non-empty value to distinguish + # true base classes from product classes like OceanBaseEngineSpec + has_non_empty_engine = False + for item in node.body: + if isinstance(item, ast.Assign): + for target in item.targets: + if isinstance(target, ast.Name) and target.id == 'engine': + # Check if engine value is non-empty string + if isinstance(item.value, ast.Constant): + has_non_empty_engine = bool(item.value.value) + break + + # True base classes: end with BaseEngineSpec AND don't define engine + # or have empty engine (like PostgresBaseEngineSpec with engine = "") + is_true_base = ( + node.name.endswith('BaseEngineSpec') and not has_non_empty_engine + ) or 'Mixin' in node.name + + # Store class info for inheritance resolution + class_info[node.name] = { + 'bases': base_names, + 'metadata': metadata, + 'engine_name': engine_name, + 'filename': filename, + 'is_base_or_mixin': is_true_base, + } + except Exception as e: + errors.append(f"{filename}: {str(e)}") + +# Second pass: resolve inheritance and build final metadata +def get_inherited_metadata(class_name, visited=None): + """Recursively get metadata from parent classes.""" + if visited is None: + visited = set() + if class_name in visited: + return {} # Prevent circular inheritance + visited.add(class_name) + + info = class_info.get(class_name) + if not info: + return {} + + # Start with parent metadata + inherited = {} + for base_name in info['bases']: + parent_metadata = get_inherited_metadata(base_name, visited.copy()) + if parent_metadata: + inherited = deep_merge(inherited, parent_metadata) + + # Merge with own metadata (own takes precedence) + if info['metadata']: + inherited = deep_merge(inherited, info['metadata']) + + return inherited + +for class_name, info in class_info.items(): + # Skip base classes and mixins + if info['is_base_or_mixin']: + continue + + debug_info["classes_found"] += 1 + + # Get final metadata with inheritance + final_metadata = get_inherited_metadata(class_name) + + # Remove compatible_databases if not defined by this class (it's not inheritable) + own_metadata = info['metadata'] or {} + if 'compatible_databases' not in own_metadata and 'compatible_databases' in final_metadata: + del final_metadata['compatible_databases'] + + # Track if we inherited anything + if final_metadata and final_metadata != own_metadata: + debug_info["inherited_metadata"] += 1 + + # Use class name as fallback for engine_name + display_name = info['engine_name'] or class_name.replace('EngineSpec', '').replace('_', ' ') + + if final_metadata and isinstance(final_metadata, dict) and display_name: + debug_info["classes_with_metadata"] += 1 + databases[display_name] = { + 'engine': display_name.lower().replace(' ', '_'), + 'engine_name': display_name, + 'module': info['filename'][:-3], # Remove .py extension + 'documentation': final_metadata, + 'time_grains': {}, + 'score': 0, + 'max_score': 0, + 'joins': True, + 'subqueries': True, + 'supports_dynamic_schema': False, + 'supports_catalog': False, + 'supports_dynamic_catalog': False, + 'ssh_tunneling': False, + 'query_cancelation': False, + 'supports_file_upload': False, + 'user_impersonation': False, + 'query_cost_estimation': False, + 'sql_validation': False, + } + +if errors and not databases: + print(json.dumps({"error": "Parse errors", "details": errors, "debug": debug_info}), file=sys.stderr) + +# Print debug info to stderr for troubleshooting +print(json.dumps(debug_info), file=sys.stderr) + +print(json.dumps(databases, default=str)) +`; + const result = spawnSync('python3', ['-c', pythonCode], { + cwd: ROOT_DIR, + encoding: 'utf-8', + timeout: 30000, + maxBuffer: 10 * 1024 * 1024, + }); + + if (result.error) { + throw result.error; + } + // Log debug info from stderr + if (result.stderr) { + console.log('Python debug info:', result.stderr.trim()); + } + if (result.status !== 0) { + throw new Error(result.stderr || 'Python script failed'); + } + const databases = JSON.parse(result.stdout); + if (Object.keys(databases).length === 0) { + throw new Error('No metadata found in engine specs'); + } + + console.log(`Extracted metadata from ${Object.keys(databases).length} engine specs`); + return databases; + } catch (err) { + console.log('Engine spec metadata extraction failed:', err.message); + return null; + } +} + +/** + * Build statistics from the database data + */ +function buildStatistics(databases) { + const stats = { + totalDatabases: Object.keys(databases).length, + withDocumentation: 0, + withConnectionString: 0, + withDrivers: 0, + withAuthMethods: 0, + supportsJoins: 0, + supportsSubqueries: 0, + supportsDynamicSchema: 0, + supportsCatalog: 0, + averageScore: 0, + maxScore: 0, + byCategory: {}, + }; + + let totalScore = 0; + + for (const [name, db] of Object.entries(databases)) { + const docs = db.documentation || {}; + + if (Object.keys(docs).length > 0) stats.withDocumentation++; + if (docs.connection_string || docs.drivers?.length > 0) + stats.withConnectionString++; + if (docs.drivers?.length > 0) stats.withDrivers++; + if (docs.authentication_methods?.length > 0) stats.withAuthMethods++; + if (db.joins) stats.supportsJoins++; + if (db.subqueries) stats.supportsSubqueries++; + if (db.supports_dynamic_schema) stats.supportsDynamicSchema++; + if (db.supports_catalog) stats.supportsCatalog++; + + totalScore += db.score || 0; + if (db.max_score > stats.maxScore) stats.maxScore = db.max_score; + + // Use categories from documentation metadata (computed by Python) + // Each database can belong to multiple categories + const categories = docs.categories || ['OTHER']; + for (const cat of categories) { + // Map category constant names to display names + const categoryDisplayNames = { + 'CLOUD_AWS': 'Cloud - AWS', + 'CLOUD_GCP': 'Cloud - Google', + 'CLOUD_AZURE': 'Cloud - Azure', + 'CLOUD_DATA_WAREHOUSES': 'Cloud Data Warehouses', + 'APACHE_PROJECTS': 'Apache Projects', + 'TRADITIONAL_RDBMS': 'Traditional RDBMS', + 'ANALYTICAL_DATABASES': 'Analytical Databases', + 'SEARCH_NOSQL': 'Search & NoSQL', + 'QUERY_ENGINES': 'Query Engines', + 'TIME_SERIES': 'Time Series Databases', + 'OTHER': 'Other Databases', + 'OPEN_SOURCE': 'Open Source', + 'HOSTED_OPEN_SOURCE': 'Hosted Open Source', + 'PROPRIETARY': 'Proprietary', + }; + const displayName = categoryDisplayNames[cat] || cat; + if (!stats.byCategory[displayName]) { + stats.byCategory[displayName] = []; + } + stats.byCategory[displayName].push(name); + } + } + + stats.averageScore = Math.round(totalScore / stats.totalDatabases); + + return stats; +} + +/** + * Convert database name to a URL-friendly slug + */ +function toSlug(name) { + return name + .toLowerCase() + .replace(/[^a-z0-9]+/g, '-') + .replace(/^-|-$/g, ''); +} + +/** + * Generate MDX content for a single database page + */ +function generateDatabaseMDX(name, db) { + const description = db.documentation?.description || `Documentation for ${name} database connection.`; + const shortDesc = description + .slice(0, 160) + .replace(/\\/g, '\\\\') + .replace(/"/g, '\\"'); + + return `--- +title: ${name} +sidebar_label: ${name} +description: "${shortDesc}" +hide_title: true +--- + +{/* +Licensed to the Apache Software Foundation (ASF) under one +or more contributor license agreements. See the NOTICE file +distributed with this work for additional information +regarding copyright ownership. The ASF licenses this file +to you under the Apache License, Version 2.0 (the +"License"); you may not use this file except in compliance +with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, +software distributed under the License is distributed on an +"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +KIND, either express or implied. See the License for the +specific language governing permissions and limitations +under the License. +*/} + +import { DatabasePage } from '@site/src/components/databases'; +import databaseData from '@site/src/data/databases.json'; + + +`; +} + +/** + * Generate the index MDX for the databases overview + */ +function generateIndexMDX(statistics, usedFlaskContext = true) { + const fallbackNotice = usedFlaskContext ? '' : ` +:::info Developer Note +This documentation was built without Flask context, so feature diagnostics (scores, time grain support, etc.) +may not reflect actual database capabilities. For full diagnostics, build docs locally with: + +\`\`\`bash +cd docs && npm run gen-db-docs +\`\`\` + +This requires a working Superset development environment. +::: + +`; + + return `--- +title: Connecting to Databases +sidebar_label: Overview +sidebar_position: 1 +--- + +{/* +Licensed to the Apache Software Foundation (ASF) under one +or more contributor license agreements. See the NOTICE file +distributed with this work for additional information +regarding copyright ownership. The ASF licenses this file +to you under the Apache License, Version 2.0 (the +"License"); you may not use this file except in compliance +with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, +software distributed under the License is distributed on an +"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +KIND, either express or implied. See the License for the +specific language governing permissions and limitations +under the License. +*/} + +import { DatabaseIndex } from '@site/src/components/databases'; +import databaseData from '@site/src/data/databases.json'; + +# Connecting to Databases + +Superset does not ship bundled with connectivity to databases. The main step in connecting +Superset to a database is to **install the proper database driver(s)** in your environment. + +:::note +You'll need to install the required packages for the database you want to use as your metadata database +as well as the packages needed to connect to the databases you want to access through Superset. +For information about setting up Superset's metadata database, please refer to +installation documentations ([Docker Compose](/docs/installation/docker-compose), [Kubernetes](/docs/installation/kubernetes)) +::: + +## Supported Databases + +Superset supports **${statistics.totalDatabases} databases** with varying levels of feature support. +Click on any database name to see detailed documentation including connection strings, +authentication methods, and configuration options. + + + +## Installing Database Drivers + +Superset requires a Python [DB-API database driver](https://peps.python.org/pep-0249/) +and a [SQLAlchemy dialect](https://docs.sqlalchemy.org/en/20/dialects/) to be installed for +each database engine you want to connect to. + +### Installing Drivers in Docker + +For Docker deployments, create a \`requirements-local.txt\` file in the \`docker\` directory: + +\`\`\`bash +# Create the requirements file +touch ./docker/requirements-local.txt + +# Add your driver (e.g., for PostgreSQL) +echo "psycopg2-binary" >> ./docker/requirements-local.txt +\`\`\` + +Then restart your containers. The drivers will be installed automatically. + +### Installing Drivers with pip + +For non-Docker installations: + +\`\`\`bash +pip install +\`\`\` + +See individual database pages for the specific driver packages needed. + +## Connecting Through the UI + +1. Go to **Settings → Data: Database Connections** +2. Click **+ DATABASE** +3. Select your database type or enter a SQLAlchemy URI +4. Click **Test Connection** to verify +5. Click **Connect** to save + +## Contributing + +To add or update database documentation, add a \`metadata\` attribute to your engine spec class in +\`superset/db_engine_specs/\`. Documentation is auto-generated from these metadata attributes. + +See [METADATA_STATUS.md](https://github.com/apache/superset/blob/master/superset/db_engine_specs/METADATA_STATUS.md) +for the current status of database documentation and the [README](https://github.com/apache/superset/blob/master/superset/db_engine_specs/README.md) for the metadata schema. +${fallbackNotice}`; +} + +const README_PATH = path.join(ROOT_DIR, 'README.md'); +const README_START_MARKER = ''; +const README_END_MARKER = ''; + +/** + * Generate the database logos HTML for README.md + * Only includes databases that have logos defined + */ +function generateReadmeLogos(databases) { + // Get databases with logos, sorted alphabetically + const dbsWithLogos = Object.entries(databases) + .filter(([, db]) => db.documentation?.logo) + .sort(([a], [b]) => a.localeCompare(b)); + + if (dbsWithLogos.length === 0) { + return ''; + } + + // Generate HTML img tags + const logoTags = dbsWithLogos.map(([name, db]) => { + const logo = db.documentation.logo; + const alt = name.toLowerCase().replace(/\s+/g, '-'); + // Use docs site URL for logos + return ` `; + }); + + return `

+${logoTags.join('\n')} +

`; +} + +/** + * Update the README.md with generated database logos + */ +function updateReadme(databases) { + if (!fs.existsSync(README_PATH)) { + console.log('README.md not found, skipping update'); + return false; + } + + const content = fs.readFileSync(README_PATH, 'utf-8'); + + // Check if markers exist + if (!content.includes(README_START_MARKER) || !content.includes(README_END_MARKER)) { + console.log('README.md missing database markers, skipping update'); + console.log(` Add ${README_START_MARKER} and ${README_END_MARKER} to enable auto-generation`); + return false; + } + + // Generate new logos section + const logosHtml = generateReadmeLogos(databases); + + // Replace content between markers + const pattern = new RegExp( + `${README_START_MARKER}[\\s\\S]*?${README_END_MARKER}`, + 'g' + ); + const newContent = content.replace( + pattern, + `${README_START_MARKER}\n${logosHtml}\n${README_END_MARKER}` + ); + + if (newContent !== content) { + fs.writeFileSync(README_PATH, newContent); + console.log('Updated README.md database logos'); + return true; + } + + console.log('README.md database logos unchanged'); + return false; +} + +/** + * Extract custom_errors from engine specs for troubleshooting documentation + * Returns a map of module names to their custom errors + */ +function extractCustomErrors() { + console.log('Extracting custom_errors from engine specs...'); + + try { + const scriptPath = path.join(__dirname, 'extract_custom_errors.py'); + const result = spawnSync('python3', [scriptPath], { + cwd: ROOT_DIR, + encoding: 'utf-8', + timeout: 30000, + maxBuffer: 10 * 1024 * 1024, + }); + + if (result.error) { + throw result.error; + } + if (result.status !== 0) { + throw new Error(result.stderr || 'Python script failed'); + } + + const customErrors = JSON.parse(result.stdout); + const moduleCount = Object.keys(customErrors).length; + const errorCount = Object.values(customErrors).reduce((sum, classes) => + sum + Object.values(classes).reduce((s, errs) => s + errs.length, 0), 0); + console.log(` Found ${errorCount} custom errors across ${moduleCount} modules`); + return customErrors; + } catch (err) { + console.log(' Could not extract custom_errors:', err.message); + return null; + } +} + +/** + * Merge custom_errors into database documentation + * Maps by module name since that's how both datasets are keyed + */ +function mergeCustomErrors(databases, customErrors) { + if (!customErrors) return; + + let mergedCount = 0; + + for (const [, db] of Object.entries(databases)) { + if (!db.module) continue; + // Normalize module name: Flask mode uses full path (superset.db_engine_specs.postgres), + // but customErrors is keyed by file stem (postgres) + const moduleName = db.module.split('.').pop(); + if (!customErrors[moduleName]) continue; + + // Get all errors from all classes in this module + const moduleErrors = customErrors[moduleName]; + const allErrors = []; + + for (const classErrors of Object.values(moduleErrors)) { + allErrors.push(...classErrors); + } + + if (allErrors.length > 0) { + // Add to documentation + db.documentation = db.documentation || {}; + db.documentation.custom_errors = allErrors; + mergedCount++; + } + } + + if (mergedCount > 0) { + console.log(` Merged custom_errors into ${mergedCount} database docs`); + } +} + +/** + * Load existing database data if available + */ +function loadExistingData() { + if (!fs.existsSync(DATA_OUTPUT_FILE)) { + return null; + } + + try { + const content = fs.readFileSync(DATA_OUTPUT_FILE, 'utf-8'); + return JSON.parse(content); + } catch (error) { + console.log('Could not load existing data:', error.message); + return null; + } +} + +/** + * Merge new documentation with existing diagnostics + * Preserves score, time_grains, and feature flags from existing data + */ +function mergeWithExistingDiagnostics(newDatabases, existingData) { + if (!existingData?.databases) return newDatabases; + + const diagnosticFields = [ + 'score', 'max_score', 'time_grains', 'joins', 'subqueries', + 'supports_dynamic_schema', 'supports_catalog', 'supports_dynamic_catalog', + 'ssh_tunneling', 'query_cancelation', 'supports_file_upload', + 'user_impersonation', 'query_cost_estimation', 'sql_validation' + ]; + + for (const [name, db] of Object.entries(newDatabases)) { + const existingDb = existingData.databases[name]; + if (existingDb && existingDb.score > 0) { + // Preserve diagnostics from existing data + for (const field of diagnosticFields) { + if (existingDb[field] !== undefined) { + db[field] = existingDb[field]; + } + } + } + } + + const preserved = Object.values(newDatabases).filter(d => d.score > 0).length; + if (preserved > 0) { + console.log(`Preserved diagnostics for ${preserved} databases from existing data`); + } + + return newDatabases; +} + +/** + * Main function + */ +async function main() { + console.log('Generating database documentation...\n'); + + // Ensure output directories exist + if (!fs.existsSync(DATA_OUTPUT_DIR)) { + fs.mkdirSync(DATA_OUTPUT_DIR, { recursive: true }); + } + if (!fs.existsSync(MDX_OUTPUT_DIR)) { + fs.mkdirSync(MDX_OUTPUT_DIR, { recursive: true }); + } + + // Load existing data for potential merge + const existingData = loadExistingData(); + + // Try sources in order of preference: + // 1. Full script with Flask context (richest data with diagnostics) + // 2. Engine spec metadata files (works in CI without Flask) + let databases = tryRunFullScript(); + let usedFlaskContext = !!databases; + + if (!databases) { + // Extract from engine spec metadata (preferred for CI) + databases = extractEngineSpecMetadata(); + } + + if (!databases || Object.keys(databases).length === 0) { + console.error('Failed to generate database documentation data.'); + console.error('Could not extract from Flask app or engine spec metadata.'); + process.exit(1); + } + + console.log(`Processed ${Object.keys(databases).length} databases\n`); + + // Check if new data has scores; if not, preserve existing diagnostics + const hasNewScores = Object.values(databases).some((db) => db.score > 0); + if (!hasNewScores && existingData) { + databases = mergeWithExistingDiagnostics(databases, existingData); + } + + // Extract and merge custom_errors for troubleshooting documentation + const customErrors = extractCustomErrors(); + mergeCustomErrors(databases, customErrors); + + // Build statistics + const statistics = buildStatistics(databases); + + // Create the final output structure + const output = { + generated: new Date().toISOString(), + statistics, + databases, + }; + + // Write the JSON file (with trailing newline for POSIX compliance) + fs.writeFileSync(DATA_OUTPUT_FILE, JSON.stringify(output, null, 2) + '\n'); + console.log(`Generated: ${path.relative(DOCS_DIR, DATA_OUTPUT_FILE)}`); + + + // Ensure supported directory exists + if (!fs.existsSync(MDX_SUPPORTED_DIR)) { + fs.mkdirSync(MDX_SUPPORTED_DIR, { recursive: true }); + } + + // Clean up old MDX files that are no longer in the database list + console.log(`\nCleaning up old MDX files in ${path.relative(DOCS_DIR, MDX_SUPPORTED_DIR)}/`); + const existingMdxFiles = fs.readdirSync(MDX_SUPPORTED_DIR).filter(f => f.endsWith('.mdx')); + const validSlugs = new Set(Object.keys(databases).map(name => `${toSlug(name)}.mdx`)); + let removedCount = 0; + for (const file of existingMdxFiles) { + if (!validSlugs.has(file)) { + fs.unlinkSync(path.join(MDX_SUPPORTED_DIR, file)); + removedCount++; + } + } + if (removedCount > 0) { + console.log(` Removed ${removedCount} outdated MDX files`); + } + + // Generate individual MDX files for each database in supported/ subdirectory + console.log(`\nGenerating MDX files in ${path.relative(DOCS_DIR, MDX_SUPPORTED_DIR)}/`); + + let mdxCount = 0; + for (const [name, db] of Object.entries(databases)) { + const slug = toSlug(name); + const mdxContent = generateDatabaseMDX(name, db); + const mdxPath = path.join(MDX_SUPPORTED_DIR, `${slug}.mdx`); + fs.writeFileSync(mdxPath, mdxContent); + mdxCount++; + } + console.log(` Generated ${mdxCount} database pages`); + + // Generate index page in parent databases/ directory + const indexContent = generateIndexMDX(statistics, usedFlaskContext); + const indexPath = path.join(MDX_OUTPUT_DIR, 'index.mdx'); + fs.writeFileSync(indexPath, indexContent); + console.log(` Generated index page`); + + // Generate _category_.json for databases/ directory + const categoryJson = { + label: 'Databases', + position: 1, + link: { + type: 'doc', + id: 'databases/index', + }, + }; + fs.writeFileSync( + path.join(MDX_OUTPUT_DIR, '_category_.json'), + JSON.stringify(categoryJson, null, 2) + '\n' + ); + + // Generate _category_.json for supported/ subdirectory (collapsible) + const supportedCategoryJson = { + label: 'Supported Databases', + position: 2, + collapsed: true, + collapsible: true, + }; + fs.writeFileSync( + path.join(MDX_SUPPORTED_DIR, '_category_.json'), + JSON.stringify(supportedCategoryJson, null, 2) + '\n' + ); + console.log(` Generated _category_.json files`); + + // Update README.md database logos (only when explicitly requested) + if (process.env.UPDATE_README === 'true' || process.argv.includes('--update-readme')) { + console.log(''); + updateReadme(databases); + } + + console.log(`\nStatistics:`); + console.log(` Total databases: ${statistics.totalDatabases}`); + console.log(` With documentation: ${statistics.withDocumentation}`); + console.log(` With connection strings: ${statistics.withConnectionString}`); + console.log(` Categories: ${Object.keys(statistics.byCategory).length}`); + + console.log('\nDone!'); +} + +main().catch(console.error); diff --git a/docs/sidebars.js b/docs/sidebars.js index 4f231d16a59..8a808ed31b6 100644 --- a/docs/sidebars.js +++ b/docs/sidebars.js @@ -57,6 +57,20 @@ const sidebars = { }, ], }, + { + type: 'category', + label: 'Databases', + link: { + type: 'doc', + id: 'databases/index', + }, + items: [ + { + type: 'autogenerated', + dirName: 'databases', + }, + ], + }, { type: 'category', label: 'Using Superset', diff --git a/docs/src/components/SectionHeader.tsx b/docs/src/components/SectionHeader.tsx index 387d021249b..d0cc50e6cda 100644 --- a/docs/src/components/SectionHeader.tsx +++ b/docs/src/components/SectionHeader.tsx @@ -98,6 +98,7 @@ interface SectionHeaderProps { title: string; subtitle?: string | ReactNode; dark?: boolean; + link?: string; } const SectionHeader = ({ @@ -105,15 +106,24 @@ const SectionHeader = ({ title, subtitle, dark, + link, }: SectionHeaderProps) => { const Heading = level; const StyledRoot = level === 'h1' ? StyledSectionHeaderH1 : StyledSectionHeaderH2; + const titleContent = link ? ( + + {title} + + ) : ( + title + ); + return ( - {title} + {titleContent} line {subtitle &&
{subtitle}
} diff --git a/docs/src/components/databases/DatabaseIndex.tsx b/docs/src/components/databases/DatabaseIndex.tsx new file mode 100644 index 00000000000..fee4f1a36bb --- /dev/null +++ b/docs/src/components/databases/DatabaseIndex.tsx @@ -0,0 +1,592 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, + * software distributed under the License is distributed on an + * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + * KIND, either express or implied. See the License for the + * specific language governing permissions and limitations + * under the License. + */ + +import React, { useState, useMemo } from 'react'; +import { Card, Row, Col, Statistic, Table, Tag, Input, Select, Tooltip } from 'antd'; +import { + DatabaseOutlined, + CheckCircleOutlined, + ApiOutlined, + KeyOutlined, + SearchOutlined, + LinkOutlined, + BugOutlined, +} from '@ant-design/icons'; +import type { DatabaseData, DatabaseInfo, TimeGrains } from './types'; + +interface DatabaseIndexProps { + data: DatabaseData; +} + +// Type for table entries (includes both regular DBs and compatible DBs) +interface TableEntry { + name: string; + categories: string[]; // Multiple categories supported + score: number; + max_score: number; + timeGrainCount: number; + time_grains?: TimeGrains; + hasDrivers: boolean; + hasAuthMethods: boolean; + hasConnectionString: boolean; + hasCustomErrors: boolean; + customErrorCount: number; + joins?: boolean; + subqueries?: boolean; + supports_dynamic_schema?: boolean; + supports_catalog?: boolean; + ssh_tunneling?: boolean; + supports_file_upload?: boolean; + query_cancelation?: boolean; + query_cost_estimation?: boolean; + user_impersonation?: boolean; + sql_validation?: boolean; + documentation?: DatabaseInfo['documentation']; + // For compatible databases + isCompatible?: boolean; + compatibleWith?: string; + compatibleDescription?: string; +} + +// Map category constant names to display names +const CATEGORY_DISPLAY_NAMES: Record = { + 'CLOUD_AWS': 'Cloud - AWS', + 'CLOUD_GCP': 'Cloud - Google', + 'CLOUD_AZURE': 'Cloud - Azure', + 'CLOUD_DATA_WAREHOUSES': 'Cloud Data Warehouses', + 'APACHE_PROJECTS': 'Apache Projects', + 'TRADITIONAL_RDBMS': 'Traditional RDBMS', + 'ANALYTICAL_DATABASES': 'Analytical Databases', + 'SEARCH_NOSQL': 'Search & NoSQL', + 'QUERY_ENGINES': 'Query Engines', + 'TIME_SERIES': 'Time Series Databases', + 'OTHER': 'Other Databases', + 'OPEN_SOURCE': 'Open Source', + 'HOSTED_OPEN_SOURCE': 'Hosted Open Source', + 'PROPRIETARY': 'Proprietary', +}; + +// Category colors for visual distinction +const CATEGORY_COLORS: Record = { + 'Cloud - AWS': 'orange', + 'Cloud - Google': 'blue', + 'Cloud - Azure': 'cyan', + 'Cloud Data Warehouses': 'purple', + 'Apache Projects': 'red', + 'Traditional RDBMS': 'green', + 'Analytical Databases': 'magenta', + 'Search & NoSQL': 'gold', + 'Query Engines': 'lime', + 'Time Series Databases': 'volcano', + 'Other Databases': 'default', + // Licensing categories + 'Open Source': 'geekblue', + 'Hosted Open Source': 'cyan', + 'Proprietary': 'default', +}; + +// Convert category constant to display name +function getCategoryDisplayName(cat: string): string { + return CATEGORY_DISPLAY_NAMES[cat] || cat; +} + +// Get categories for a database - uses categories from metadata when available +// Falls back to name-based inference for compatible databases without categories +function getCategories( + name: string, + documentationCategories?: string[] +): string[] { + // Prefer categories from documentation metadata (computed by Python) + if (documentationCategories && documentationCategories.length > 0) { + return documentationCategories.map(getCategoryDisplayName); + } + + // Fallback: infer from name (for compatible databases without categories) + const nameLower = name.toLowerCase(); + + if (nameLower.includes('aws') || nameLower.includes('amazon')) + return ['Cloud - AWS']; + if (nameLower.includes('google') || nameLower.includes('bigquery')) + return ['Cloud - Google']; + if (nameLower.includes('azure') || nameLower.includes('microsoft')) + return ['Cloud - Azure']; + if (nameLower.includes('snowflake') || nameLower.includes('databricks')) + return ['Cloud Data Warehouses']; + if ( + nameLower.includes('apache') || + nameLower.includes('druid') || + nameLower.includes('hive') || + nameLower.includes('spark') + ) + return ['Apache Projects']; + if ( + nameLower.includes('postgres') || + nameLower.includes('mysql') || + nameLower.includes('sqlite') || + nameLower.includes('mariadb') + ) + return ['Traditional RDBMS']; + if ( + nameLower.includes('clickhouse') || + nameLower.includes('vertica') || + nameLower.includes('starrocks') + ) + return ['Analytical Databases']; + if ( + nameLower.includes('elastic') || + nameLower.includes('solr') || + nameLower.includes('couchbase') + ) + return ['Search & NoSQL']; + if (nameLower.includes('trino') || nameLower.includes('presto')) + return ['Query Engines']; + + return ['Other Databases']; +} + +// Count supported time grains +function countTimeGrains(db: DatabaseInfo): number { + if (!db.time_grains) return 0; + return Object.values(db.time_grains).filter(Boolean).length; +} + +// Format time grain name for display (e.g., FIVE_MINUTES -> "5 min") +function formatTimeGrain(grain: string): string { + const mapping: Record = { + SECOND: 'Second', + FIVE_SECONDS: '5 sec', + THIRTY_SECONDS: '30 sec', + MINUTE: 'Minute', + FIVE_MINUTES: '5 min', + TEN_MINUTES: '10 min', + FIFTEEN_MINUTES: '15 min', + THIRTY_MINUTES: '30 min', + HALF_HOUR: '30 min', + HOUR: 'Hour', + SIX_HOURS: '6 hours', + DAY: 'Day', + WEEK: 'Week', + WEEK_STARTING_SUNDAY: 'Week (Sun)', + WEEK_STARTING_MONDAY: 'Week (Mon)', + WEEK_ENDING_SATURDAY: 'Week (→Sat)', + WEEK_ENDING_SUNDAY: 'Week (→Sun)', + MONTH: 'Month', + QUARTER: 'Quarter', + QUARTER_YEAR: 'Quarter', + YEAR: 'Year', + }; + return mapping[grain] || grain; +} + +// Get list of supported time grains for tooltip +function getSupportedTimeGrains(timeGrains?: TimeGrains): string[] { + if (!timeGrains) return []; + return Object.entries(timeGrains) + .filter(([, supported]) => supported) + .map(([grain]) => formatTimeGrain(grain)); +} + +const DatabaseIndex: React.FC = ({ data }) => { + const [searchText, setSearchText] = useState(''); + const [categoryFilter, setCategoryFilter] = useState(null); + + const { statistics, databases } = data; + + // Convert databases object to array, including compatible databases + const databaseList = useMemo(() => { + const entries: TableEntry[] = []; + + Object.entries(databases).forEach(([name, db]) => { + // Add the main database + // Use categories from documentation metadata (computed by Python) when available + entries.push({ + ...db, + name, + categories: getCategories(name, db.documentation?.categories), + timeGrainCount: countTimeGrains(db), + hasDrivers: (db.documentation?.drivers?.length ?? 0) > 0, + hasAuthMethods: (db.documentation?.authentication_methods?.length ?? 0) > 0, + hasConnectionString: Boolean( + db.documentation?.connection_string || + (db.documentation?.drivers?.length ?? 0) > 0 + ), + hasCustomErrors: (db.documentation?.custom_errors?.length ?? 0) > 0, + customErrorCount: db.documentation?.custom_errors?.length ?? 0, + isCompatible: false, + }); + + // Add compatible databases from this database's documentation + const compatibleDbs = db.documentation?.compatible_databases ?? []; + compatibleDbs.forEach((compat) => { + // Check if this compatible DB already exists as a main entry + const existsAsMain = Object.keys(databases).some( + (dbName) => dbName.toLowerCase() === compat.name.toLowerCase() + ); + + if (!existsAsMain) { + // Compatible databases: use their categories if defined, or infer from name + entries.push({ + name: compat.name, + categories: getCategories(compat.name, compat.categories), + // Compatible DBs inherit scores from parent + score: db.score, + max_score: db.max_score, + timeGrainCount: countTimeGrains(db), + hasDrivers: false, + hasAuthMethods: false, + hasConnectionString: Boolean(compat.connection_string), + hasCustomErrors: false, + customErrorCount: 0, + joins: db.joins, + subqueries: db.subqueries, + supports_dynamic_schema: db.supports_dynamic_schema, + supports_catalog: db.supports_catalog, + ssh_tunneling: db.ssh_tunneling, + documentation: { + description: compat.description, + connection_string: compat.connection_string, + pypi_packages: compat.pypi_packages, + }, + isCompatible: true, + compatibleWith: name, + compatibleDescription: `Uses ${name} driver`, + }); + } + }); + }); + + return entries; + }, [databases]); + + // Filter and sort databases + const filteredDatabases = useMemo(() => { + return databaseList + .filter((db) => { + const matchesSearch = + !searchText || + db.name.toLowerCase().includes(searchText.toLowerCase()) || + db.documentation?.description + ?.toLowerCase() + .includes(searchText.toLowerCase()); + const matchesCategory = !categoryFilter || db.categories.includes(categoryFilter); + return matchesSearch && matchesCategory; + }) + .sort((a, b) => b.score - a.score); + }, [databaseList, searchText, categoryFilter]); + + // Get unique categories and counts for filter + const { categories, categoryCounts } = useMemo(() => { + const counts: Record = {}; + databaseList.forEach((db) => { + // Count each category the database belongs to + db.categories.forEach((cat) => { + counts[cat] = (counts[cat] || 0) + 1; + }); + }); + return { + categories: Object.keys(counts).sort(), + categoryCounts: counts, + }; + }, [databaseList]); + + // Table columns + const columns = [ + { + title: 'Database', + dataIndex: 'name', + key: 'name', + sorter: (a: TableEntry, b: TableEntry) => a.name.localeCompare(b.name), + render: (name: string, record: TableEntry) => { + // Convert name to URL slug + const toSlug = (n: string) => n.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, ''); + + // Link to parent for compatible DBs, otherwise to own page + const linkTarget = record.isCompatible && record.compatibleWith + ? `/docs/databases/supported/${toSlug(record.compatibleWith)}` + : `/docs/databases/supported/${toSlug(name)}`; + + return ( +
+ + {name} + + {record.isCompatible && record.compatibleWith && ( + } + color="geekblue" + style={{ marginLeft: 8, fontSize: '11px' }} + > + {record.compatibleWith} compatible + + )} +
+ {record.documentation?.description?.slice(0, 80)} + {(record.documentation?.description?.length ?? 0) > 80 ? '...' : ''} +
+
+ ); + }, + }, + { + title: 'Categories', + dataIndex: 'categories', + key: 'categories', + width: 220, + filters: categories.map((cat) => ({ text: cat, value: cat })), + onFilter: (value: React.Key | boolean, record: TableEntry) => + record.categories.includes(value as string), + render: (cats: string[]) => ( +
+ {cats.map((cat) => ( + {cat} + ))} +
+ ), + }, + { + title: 'Score', + dataIndex: 'score', + key: 'score', + width: 80, + sorter: (a: TableEntry, b: TableEntry) => a.score - b.score, + defaultSortOrder: 'descend' as const, + render: (score: number, record: TableEntry) => ( + 150 ? '#52c41a' : score > 100 ? '#1890ff' : '#666', + fontWeight: score > 150 ? 'bold' : 'normal', + }} + > + {score}/{record.max_score} + + ), + }, + { + title: 'Time Grains', + dataIndex: 'timeGrainCount', + key: 'timeGrainCount', + width: 100, + sorter: (a: TableEntry, b: TableEntry) => a.timeGrainCount - b.timeGrainCount, + render: (count: number, record: TableEntry) => { + if (count === 0) return -; + const grains = getSupportedTimeGrains(record.time_grains); + return ( + + {grains.map((grain) => ( + {grain} + ))} +
+ } + placement="top" + > + + {count} grains + + + ); + }, + }, + { + title: 'Features', + key: 'features', + width: 280, + filters: [ + { text: 'JOINs', value: 'joins' }, + { text: 'Subqueries', value: 'subqueries' }, + { text: 'Dynamic Schema', value: 'dynamic_schema' }, + { text: 'Catalog', value: 'catalog' }, + { text: 'SSH Tunneling', value: 'ssh' }, + { text: 'File Upload', value: 'file_upload' }, + { text: 'Query Cancel', value: 'query_cancel' }, + { text: 'Cost Estimation', value: 'cost_estimation' }, + { text: 'User Impersonation', value: 'impersonation' }, + { text: 'SQL Validation', value: 'sql_validation' }, + ], + onFilter: (value: React.Key | boolean, record: TableEntry) => { + switch (value) { + case 'joins': + return Boolean(record.joins); + case 'subqueries': + return Boolean(record.subqueries); + case 'dynamic_schema': + return Boolean(record.supports_dynamic_schema); + case 'catalog': + return Boolean(record.supports_catalog); + case 'ssh': + return Boolean(record.ssh_tunneling); + case 'file_upload': + return Boolean(record.supports_file_upload); + case 'query_cancel': + return Boolean(record.query_cancelation); + case 'cost_estimation': + return Boolean(record.query_cost_estimation); + case 'impersonation': + return Boolean(record.user_impersonation); + case 'sql_validation': + return Boolean(record.sql_validation); + default: + return true; + } + }, + render: (_: unknown, record: TableEntry) => ( +
+ {record.joins && JOINs} + {record.subqueries && Subqueries} + {record.supports_dynamic_schema && Dynamic Schema} + {record.supports_catalog && Catalog} + {record.ssh_tunneling && SSH} + {record.supports_file_upload && File Upload} + {record.query_cancelation && Query Cancel} + {record.query_cost_estimation && Cost Est.} + {record.user_impersonation && Impersonation} + {record.sql_validation && SQL Validation} +
+ ), + }, + { + title: 'Documentation', + key: 'docs', + width: 180, + render: (_: unknown, record: TableEntry) => ( +
+ {record.hasConnectionString && ( + } color="default"> + Connection + + )} + {record.hasDrivers && ( + } color="default"> + Drivers + + )} + {record.hasAuthMethods && ( + } color="default"> + Auth + + )} + {record.hasCustomErrors && ( + + } color="volcano"> + Errors + + + )} +
+ ), + }, + ]; + + return ( +
+ {/* Statistics Cards */} + + + + } + /> + + + + + } + suffix={`/ ${statistics.totalDatabases}`} + /> + + + + + } + /> + + + + + } + /> + + + + + {/* Filters */} + + + } + value={searchText} + onChange={(e) => setSearchText(e.target.value)} + allowClear + /> + + + - )} - + + ); } - return
; + return null; }; - const renderRowsReturned = (alertMessage: boolean) => { + const renderRowsReturned = () => { const { results, rows, queryLimit, limitingFactor } = query; let limitMessage = ''; const limitReached = results?.displayLimitReached; const limit = queryLimit || results.query.limit; - const isAdmin = !!user?.roles?.Admin; - const rowsCount = Math.min(rows || 0, results?.data?.length || 0); - - const displayMaxRowsReachedMessage = { - withAdmin: t( - 'The number of results displayed is limited to %(rows)d by the configuration DISPLAY_MAX_ROW. ' + - 'Please add additional limits/filters or download to csv to see more rows up to ' + - 'the %(limit)d limit.', - { rows: rowsCount, limit }, - ), - withoutAdmin: t( - 'The number of results displayed is limited to %(rows)d. ' + - 'Please add additional limits/filters, download to csv, or contact an admin ' + - 'to see more rows up to the %(limit)d limit.', - { rows: rowsCount, limit }, - ), - }; const shouldUseDefaultDropdownAlert = limit === defaultQueryLimit && limitingFactor === LimitingFactor.Dropdown; @@ -514,76 +498,53 @@ const ResultSet = ({ 'The number of rows displayed is limited to %(rows)d by the query and limit dropdown.', { rows }, ); + } else if (shouldUseDefaultDropdownAlert) { + limitMessage = t( + 'The number of rows displayed is limited to %(rows)d by the dropdown.', + { rows }, + ); + } else if (limitReached) { + limitMessage = t( + 'The number of results displayed is limited to %(rows)d.', + { rows }, + ); } + const formattedRowCount = getNumberFormatter()(rows); const rowsReturnedMessage = t('%(rows)d rows returned', { rows, }); - const tooltipText = `${rowsReturnedMessage}. ${limitMessage}`; - - if (alertMessage) { - return ( - <> - {!limitReached && shouldUseDefaultDropdownAlert && ( -
- -
- )} - {limitReached && ( -
- -
- )} - - ); - } - const showRowsReturned = - showSqlInline || (!limitReached && !shouldUseDefaultDropdownAlert); + const hasWarning = !!limitMessage; + const tooltipText = hasWarning + ? `${rowsReturnedMessage}. ${limitMessage}` + : rowsReturnedMessage; return ( - <> - {showRowsReturned && ( - - - - )} - + /> + )} + {tn('%s row', '%s rows', rows, formattedRowCount)} + + + ); }; @@ -708,9 +669,6 @@ const ResultSet = ({ ({ data } = results); } if (data && data.length > 0) { - const expandedColumns = results.expanded_columns - ? results.expanded_columns.map(col => col.column_name) - : []; const allowHTML = getItem( LocalStorageKeys.SqllabIsRenderHtmlEnabled, true, @@ -719,7 +677,7 @@ const ResultSet = ({ const tableProps = { data, queryId: query.id, - orderedColumnKeys: results.columns.map(col => col.column_name), + orderedColumnKeys, filterText: searchText, expandedColumns, allowHTML, @@ -728,45 +686,58 @@ const ResultSet = ({ return ( <> - {renderControls()} - {showSql && showSqlInline ? ( - <> -
- + {renderControls()} + + {showSql && ( + <> + - {renderRowsReturned(true)} - - ) : ( - <> - {renderRowsReturned(false)} - {renderRowsReturned(true)} - {sql} - - )} +
+ + + )} + {renderRowsReturned()} + {search && ( + + )} +
{useFixedHeight && height !== undefined ? ( ) : ( @@ -856,34 +827,20 @@ const ResultSet = ({ } } - let progressBar; - if (query.progress > 0) { - progressBar = ( - - ); - } - const progressMsg = query?.extra?.progress ?? null; return ( - <> - -
{!progressBar && }
- {/* show loading bar whenever progress bar is completed but needs time to render */} -
{query.progress === 100 && }
- -
- {progressMsg && } -
-
{query.progress !== 100 && progressBar}
- {trackingUrl &&
{trackingUrl}
} - + + {progressMsg && ( + + )} + {trackingUrl &&
{trackingUrl}
} - + ); }; diff --git a/superset-frontend/src/SqlLab/components/SaveQuery/index.tsx b/superset-frontend/src/SqlLab/components/SaveQuery/index.tsx index 96e025ac485..6d46c4cd78a 100644 --- a/superset-frontend/src/SqlLab/components/SaveQuery/index.tsx +++ b/superset-frontend/src/SqlLab/components/SaveQuery/index.tsx @@ -62,6 +62,7 @@ export type QueryPayload = { } & Pick; const Styles = styled.span` + display: contents; span[role='img']:not([aria-label='down']) { display: flex; margin: 0; diff --git a/superset-frontend/src/SqlLab/components/SouthPane/Results.tsx b/superset-frontend/src/SqlLab/components/SouthPane/Results.tsx index 661efb7171d..77345a05073 100644 --- a/superset-frontend/src/SqlLab/components/SouthPane/Results.tsx +++ b/superset-frontend/src/SqlLab/components/SouthPane/Results.tsx @@ -16,7 +16,7 @@ * specific language governing permissions and limitations * under the License. */ -import { FC } from 'react'; +import { FC, useMemo } from 'react'; import { shallowEqual, useSelector } from 'react-redux'; import { EmptyState } from '@superset-ui/core/components'; import { t } from '@apache-superset/core'; @@ -26,6 +26,7 @@ import { styled, Alert } from '@apache-superset/core/ui'; import { SqlLabRootState } from 'src/SqlLab/types'; import ResultSet from '../ResultSet'; import { LOCALSTORAGE_MAX_QUERY_AGE_MS } from '../../constants'; +import QueryStatusBar from '../QueryStatusBar'; type Props = { latestQueryId?: string; @@ -53,10 +54,14 @@ const Results: FC = ({ ({ sqlLab: { databases } }: SqlLabRootState) => databases, shallowEqual, ); - const latestQuery = useSelector( - ({ sqlLab: { queries } }: SqlLabRootState) => queries[latestQueryId || ''], + const queries = useSelector( + ({ sqlLab: { queries } }: SqlLabRootState) => queries, shallowEqual, ); + const latestQuery = useMemo( + () => queries[latestQueryId ?? ''], + [queries, latestQueryId], + ); if ( !latestQuery || @@ -72,30 +77,32 @@ const Results: FC = ({ ); } - if ( + const hasNoStoredResults = isFeatureEnabled(FeatureFlag.SqllabBackendPersistence) && latestQuery.state === 'success' && !latestQuery.resultsKey && - !latestQuery.results - ) { - return ( - - ); - } + !latestQuery.results; return ( - + <> + + {hasNoStoredResults ? ( + + ) : ( + + )} + ); }; diff --git a/superset-frontend/src/SqlLab/components/SouthPane/index.tsx b/superset-frontend/src/SqlLab/components/SouthPane/index.tsx index 1f4697db6b8..4478e716bdc 100644 --- a/superset-frontend/src/SqlLab/components/SouthPane/index.tsx +++ b/superset-frontend/src/SqlLab/components/SouthPane/index.tsx @@ -29,7 +29,7 @@ import { Flex, Label } from '@superset-ui/core/components'; import { Icons } from '@superset-ui/core/components/Icons'; import { SqlLabRootState } from 'src/SqlLab/types'; import { ViewContribution } from 'src/SqlLab/contributions'; -import MenuListExtension from 'src/components/MenuListExtension'; +import PanelToolbar from 'src/components/PanelToolbar'; import { useExtensionsContext } from 'src/extensions/ExtensionsContext'; import ExtensionsManager from 'src/extensions/ExtensionsManager'; import useQueryEditor from 'src/SqlLab/hooks/useQueryEditor'; @@ -215,7 +215,18 @@ const SouthPane = ({ ...contributions.map(contribution => ({ key: contribution.id, label: contribution.name, - children: getView(contribution.id), + children: ( +
div:first-of-type { + padding-bottom: ${theme.sizeUnit * 2}px; + } + `} + > + + {getView(contribution.id)} +
+ ), forceRender: true, closable: false, })), @@ -231,8 +242,7 @@ const SouthPane = ({ padding: 8px; `} > - - + ), }} diff --git a/superset-frontend/src/SqlLab/components/SqlEditor/index.tsx b/superset-frontend/src/SqlLab/components/SqlEditor/index.tsx index 8426a3f9811..da2caaf006b 100644 --- a/superset-frontend/src/SqlLab/components/SqlEditor/index.tsx +++ b/superset-frontend/src/SqlLab/components/SqlEditor/index.tsx @@ -760,23 +760,19 @@ const SqlEditor: FC = ({ stopQuery={stopQuery} overlayCreateAsMenu={showMenu ? runMenuBtn : null} /> - - - + {isFeatureEnabled(FeatureFlag.EstimateQueryCost) && database?.allows_cost_estimate && ( - - - + )} = ({ `} > {' '} - {t(`You are edting a query from the virtual dataset `) + + {t(`You are editing a query from the virtual dataset `) + queryEditor.name}

({ +jest.mock('src/components/PanelToolbar', () => ({ __esModule: true, default: ({ - children, viewId, - primary, - secondary, - defaultItems, + defaultPrimaryActions, + defaultSecondaryActions, }: { - children?: React.ReactNode; viewId: string; - primary?: boolean; - secondary?: boolean; - defaultItems?: MenuItemType[]; + defaultPrimaryActions?: React.ReactNode; + defaultSecondaryActions?: MenuItemType[]; }) => (

- {children} + {defaultPrimaryActions}
), })); @@ -63,30 +57,23 @@ const setup = (props?: Partial) => test('renders SqlEditorTopBar component', () => { setup(); - const menuExtensions = screen.getAllByTestId('mock-menu-extension'); - expect(menuExtensions).toHaveLength(2); + const panelToolbar = screen.getByTestId('mock-panel-toolbar'); + expect(panelToolbar).toBeInTheDocument(); }); -test('renders primary MenuListExtension with correct props', () => { +test('renders PanelToolbar with correct viewId', () => { setup(); - const menuExtensions = screen.getAllByTestId('mock-menu-extension'); - const primaryExtension = menuExtensions[0]; - - expect(primaryExtension).toHaveAttribute('data-view-id', 'sqllab.editor'); - expect(primaryExtension).toHaveAttribute('data-primary', 'true'); + const panelToolbar = screen.getByTestId('mock-panel-toolbar'); + expect(panelToolbar).toHaveAttribute('data-view-id', 'sqllab.editor'); }); -test('renders secondary MenuListExtension with correct props', () => { +test('renders PanelToolbar with correct secondary actions count', () => { setup(); - const menuExtensions = screen.getAllByTestId('mock-menu-extension'); - const secondaryExtension = menuExtensions[1]; - - expect(secondaryExtension).toHaveAttribute('data-view-id', 'sqllab.editor'); - expect(secondaryExtension).toHaveAttribute('data-secondary', 'true'); - expect(secondaryExtension).toHaveAttribute('data-default-items-count', '2'); + const panelToolbar = screen.getByTestId('mock-panel-toolbar'); + expect(panelToolbar).toHaveAttribute('data-default-secondary-count', '2'); }); -test('renders defaultPrimaryActions as children of primary MenuListExtension', () => { +test('renders defaultPrimaryActions', () => { setup(); expect( screen.getByRole('button', { name: 'Primary Action' }), @@ -114,17 +101,6 @@ test('renders with custom primary actions', () => { test('renders with empty secondary actions', () => { setup({ defaultSecondaryActions: [] }); - const menuExtensions = screen.getAllByTestId('mock-menu-extension'); - const secondaryExtension = menuExtensions[1]; - - expect(secondaryExtension).toHaveAttribute('data-default-items-count', '0'); -}); - -test('passes correct viewId (ViewContribution.Editor) to MenuListExtension', () => { - setup(); - const menuExtensions = screen.getAllByTestId('mock-menu-extension'); - - menuExtensions.forEach(extension => { - expect(extension).toHaveAttribute('data-view-id', 'sqllab.editor'); - }); + const panelToolbar = screen.getByTestId('mock-panel-toolbar'); + expect(panelToolbar).toHaveAttribute('data-default-secondary-count', '0'); }); diff --git a/superset-frontend/src/SqlLab/components/SqlEditorTopBar/index.tsx b/superset-frontend/src/SqlLab/components/SqlEditorTopBar/index.tsx index f8b7ead860b..0a3f00da3f9 100644 --- a/superset-frontend/src/SqlLab/components/SqlEditorTopBar/index.tsx +++ b/superset-frontend/src/SqlLab/components/SqlEditorTopBar/index.tsx @@ -16,25 +16,21 @@ * specific language governing permissions and limitations * under the License. */ -import { Divider, Flex } from '@superset-ui/core/components'; +import { Flex } from '@superset-ui/core/components'; import { styled } from '@apache-superset/core/ui'; +import { MenuItemType } from '@superset-ui/core/components/Menu'; import { ViewContribution } from 'src/SqlLab/contributions'; -import MenuListExtension, { - type MenuListExtensionProps, -} from 'src/components/MenuListExtension'; +import PanelToolbar from 'src/components/PanelToolbar'; const StyledFlex = styled(Flex)` margin-bottom: ${({ theme }) => theme.sizeUnit * 2}px; - - & .ant-divider { - margin: ${({ theme }) => theme.sizeUnit * 2}px 0; - height: ${({ theme }) => theme.sizeUnit * 6}px; - } + padding: ${({ theme }) => theme.sizeUnit}px 0; `; + export interface SqlEditorTopBarProps { queryEditorId: string; defaultPrimaryActions: React.ReactNode; - defaultSecondaryActions: MenuListExtensionProps['defaultItems']; + defaultSecondaryActions: MenuItemType[]; } const SqlEditorTopBar = ({ @@ -43,18 +39,11 @@ const SqlEditorTopBar = ({ }: SqlEditorTopBarProps) => ( - - - {defaultPrimaryActions} - - - - - ); diff --git a/superset-frontend/src/SqlLab/contributions.ts b/superset-frontend/src/SqlLab/contributions.ts index b9549bed28a..bdaf184e325 100644 --- a/superset-frontend/src/SqlLab/contributions.ts +++ b/superset-frontend/src/SqlLab/contributions.ts @@ -21,4 +21,6 @@ export enum ViewContribution { Panels = 'sqllab.panels', Editor = 'sqllab.editor', StatusBar = 'sqllab.statusBar', + Results = 'sqllab.results', + QueryHistory = 'sqllab.queryHistory', } diff --git a/superset-frontend/src/assets/images/icons/multiple.svg b/superset-frontend/src/assets/images/icons/multiple.svg new file mode 100644 index 00000000000..bef9472b7ca --- /dev/null +++ b/superset-frontend/src/assets/images/icons/multiple.svg @@ -0,0 +1,21 @@ + + + + diff --git a/superset-frontend/src/components/Datasource/components/DatasourceEditor/DatasourceEditor.jsx b/superset-frontend/src/components/Datasource/components/DatasourceEditor/DatasourceEditor.jsx index fc220317599..242ab820a92 100644 --- a/superset-frontend/src/components/Datasource/components/DatasourceEditor/DatasourceEditor.jsx +++ b/superset-frontend/src/components/Datasource/components/DatasourceEditor/DatasourceEditor.jsx @@ -328,6 +328,7 @@ function ColumnCollectionTable({ control={ { @@ -1510,7 +1510,7 @@ const FiltersConfigForm = ( initialValue={hasDefaultValue} title={ isChartCustomization - ? t('Customization has default value') + ? t('Display control has default value') : t('Filter has default value') } tooltip={defaultValueTooltip} diff --git a/superset-frontend/src/dashboard/components/nativeFilters/FiltersConfigModal/FiltersConfigModal.tsx b/superset-frontend/src/dashboard/components/nativeFilters/FiltersConfigModal/FiltersConfigModal.tsx index e1ad879c637..659f0154c87 100644 --- a/superset-frontend/src/dashboard/components/nativeFilters/FiltersConfigModal/FiltersConfigModal.tsx +++ b/superset-frontend/src/dashboard/components/nativeFilters/FiltersConfigModal/FiltersConfigModal.tsx @@ -503,7 +503,7 @@ function FiltersConfigModal({ = ({ onAddFilter, onAddCustomization }) => { }, { key: 'customization', - label: t('Add customization'), + label: t('Add display control'), icon: ( { const { result } = renderHook(() => useIsFilterInScope()); expect(result.current(filter)).toBe(true); }); + +test('filter should be hidden on excluded nested tab even when parent tab is active', () => { + (useSelector as jest.Mock).mockImplementation((selector: Function) => { + const mockState = { + dashboardState: { activeTabs: ['TAB-Parent1', 'TAB-P1_Child2'] }, + dashboardLayout: { + present: { + 'CHART-1': { + type: 'CHART', + meta: { chartId: 1 }, + parents: ['ROOT_ID', 'TAB-Parent1', 'TAB-P1_Child1'], + }, + 'CHART-2': { + type: 'CHART', + meta: { chartId: 2 }, + parents: ['ROOT_ID', 'TAB-Parent1', 'TAB-P1_Child1'], + }, + 'CHART-5': { + type: 'CHART', + meta: { chartId: 5 }, + parents: ['ROOT_ID', 'TAB-Parent2'], + }, + 'CHART-6': { + type: 'CHART', + meta: { chartId: 6 }, + parents: ['ROOT_ID', 'TAB-Parent2'], + }, + 'TAB-Parent1': { type: 'TAB', id: 'TAB-Parent1' }, + 'TAB-P1_Child1': { type: 'TAB', id: 'TAB-P1_Child1' }, + 'TAB-P1_Child2': { type: 'TAB', id: 'TAB-P1_Child2' }, + 'TAB-Parent2': { type: 'TAB', id: 'TAB-Parent2' }, + }, + }, + }; + return selector(mockState); + }); + + const filter: Filter = { + id: 'filter_nested', + name: 'Nested Tab Filter', + filterType: 'filter_select', + type: NativeFilterType.NativeFilter, + chartsInScope: [1, 2, 5, 6], + scope: { rootPath: ['TAB-P1_Child1', 'TAB-Parent2'], excluded: [3, 4] }, + controlValues: {}, + defaultDataMask: {}, + cascadeParentIds: [], + targets: [{ column: { name: 'column_name' }, datasetId: 1 }], + description: 'Filter excluding P1_Child2', + }; + + const { result } = renderHook(() => useIsFilterInScope()); + expect(result.current(filter)).toBe(false); +}); + +test('filter should be visible on included nested tab', () => { + (useSelector as jest.Mock).mockImplementation((selector: Function) => { + const mockState = { + dashboardState: { activeTabs: ['TAB-Parent1', 'TAB-P1_Child1'] }, + dashboardLayout: { + present: { + 'CHART-1': { + type: 'CHART', + meta: { chartId: 1 }, + parents: ['ROOT_ID', 'TAB-Parent1', 'TAB-P1_Child1'], + }, + 'CHART-2': { + type: 'CHART', + meta: { chartId: 2 }, + parents: ['ROOT_ID', 'TAB-Parent1', 'TAB-P1_Child1'], + }, + 'TAB-Parent1': { type: 'TAB', id: 'TAB-Parent1' }, + 'TAB-P1_Child1': { type: 'TAB', id: 'TAB-P1_Child1' }, + 'TAB-P1_Child2': { type: 'TAB', id: 'TAB-P1_Child2' }, + }, + }, + }; + return selector(mockState); + }); + + const filter: Filter = { + id: 'filter_nested_visible', + name: 'Nested Tab Filter Visible', + filterType: 'filter_select', + type: NativeFilterType.NativeFilter, + chartsInScope: [1, 2, 5, 6], + scope: { rootPath: ['TAB-P1_Child1', 'TAB-Parent2'], excluded: [3, 4] }, + controlValues: {}, + defaultDataMask: {}, + cascadeParentIds: [], + targets: [{ column: { name: 'column_name' }, datasetId: 1 }], + description: 'Filter including P1_Child1', + }; + + const { result } = renderHook(() => useIsFilterInScope()); + expect(result.current(filter)).toBe(true); +}); + +test('filter should be visible on top-level tab when charts have no nested parents', () => { + (useSelector as jest.Mock).mockImplementation((selector: Function) => { + const mockState = { + dashboardState: { activeTabs: ['TAB-Parent2'] }, + dashboardLayout: { + present: { + 'CHART-5': { + type: 'CHART', + meta: { chartId: 5 }, + parents: ['ROOT_ID', 'TAB-Parent2'], + }, + 'CHART-6': { + type: 'CHART', + meta: { chartId: 6 }, + parents: ['ROOT_ID', 'TAB-Parent2'], + }, + 'TAB-Parent2': { type: 'TAB', id: 'TAB-Parent2' }, + }, + }, + }; + return selector(mockState); + }); + + const filter: Filter = { + id: 'filter_top_level', + name: 'Top Level Tab Filter', + filterType: 'filter_select', + type: NativeFilterType.NativeFilter, + chartsInScope: [1, 2, 5, 6], + scope: { rootPath: ['TAB-P1_Child1', 'TAB-Parent2'], excluded: [3, 4] }, + controlValues: {}, + defaultDataMask: {}, + cascadeParentIds: [], + targets: [{ column: { name: 'column_name' }, datasetId: 1 }], + description: 'Filter including Parent2', + }; + + const { result } = renderHook(() => useIsFilterInScope()); + expect(result.current(filter)).toBe(true); +}); + +test('filter with chartsInScope referencing non-existent chart should still work', () => { + (useSelector as jest.Mock).mockImplementation((selector: Function) => { + const mockState = { + dashboardState: { activeTabs: ['TAB-Parent1'] }, + dashboardLayout: { + present: { + 'CHART-1': { + type: 'CHART', + meta: { chartId: 1 }, + parents: ['ROOT_ID', 'TAB-Parent1'], + }, + 'TAB-Parent1': { type: 'TAB', id: 'TAB-Parent1' }, + }, + }, + }; + return selector(mockState); + }); + + const filter: Filter = { + id: 'filter_missing_chart', + name: 'Filter With Missing Chart', + filterType: 'filter_select', + type: NativeFilterType.NativeFilter, + chartsInScope: [999], + scope: { rootPath: ['TAB-Parent1'], excluded: [] }, + controlValues: {}, + defaultDataMask: {}, + cascadeParentIds: [], + targets: [{ column: { name: 'column_name' }, datasetId: 1 }], + description: 'Filter referencing non-existent chart', + }; + + const { result } = renderHook(() => useIsFilterInScope()); + expect(result.current(filter)).toBe(true); +}); + +test('filter with mix of existing and non-existent charts in chartsInScope', () => { + (useSelector as jest.Mock).mockImplementation((selector: Function) => { + const mockState = { + dashboardState: { activeTabs: ['TAB-Parent2'] }, + dashboardLayout: { + present: { + 'CHART-1': { + type: 'CHART', + meta: { chartId: 1 }, + parents: ['ROOT_ID', 'TAB-Parent1'], + }, + 'TAB-Parent1': { type: 'TAB', id: 'TAB-Parent1' }, + 'TAB-Parent2': { type: 'TAB', id: 'TAB-Parent2' }, + }, + }, + }; + return selector(mockState); + }); + + const filter: Filter = { + id: 'filter_mixed_charts', + name: 'Filter With Mixed Charts', + filterType: 'filter_select', + type: NativeFilterType.NativeFilter, + chartsInScope: [1, 999], + scope: { rootPath: ['TAB-Parent1'], excluded: [] }, + controlValues: {}, + defaultDataMask: {}, + cascadeParentIds: [], + targets: [{ column: { name: 'column_name' }, datasetId: 1 }], + description: 'Filter with mix of existing and non-existent charts', + }; + + const { result } = renderHook(() => useIsFilterInScope()); + expect(result.current(filter)).toBe(true); +}); diff --git a/superset-frontend/src/dashboard/components/nativeFilters/state.ts b/superset-frontend/src/dashboard/components/nativeFilters/state.ts index 1989d879e2a..431994da6f8 100644 --- a/superset-frontend/src/dashboard/components/nativeFilters/state.ts +++ b/superset-frontend/src/dashboard/components/nativeFilters/state.ts @@ -203,10 +203,12 @@ export function useIsFilterInScope() { (filter: FilterElement | Divider) => { if (filter.type === NativeFilterType.Divider) return true; - const isChartInScope = - Array.isArray(filter.chartsInScope) && - filter.chartsInScope.length > 0 && - filter.chartsInScope.some((chartId: number) => { + const hasChartsInScope = + Array.isArray(filter.chartsInScope) && filter.chartsInScope.length > 0; + + let isChartInScope = false; + if (hasChartsInScope) { + isChartInScope = filter.chartsInScope!.some((chartId: number) => { const tabParents = selectChartTabParents(chartId); return ( !tabParents || @@ -214,6 +216,7 @@ export function useIsFilterInScope() { tabParents.every(tab => activeTabs.includes(tab)) ); }); + } if (isChartCustomization(filter)) { const isCustomizationInActiveTab = filter.tabsInScope?.some(tab => @@ -222,11 +225,13 @@ export function useIsFilterInScope() { return isChartInScope || isCustomizationInActiveTab; } - const isFilterInActiveTab = filter.scope?.rootPath?.some(tab => - activeTabs.includes(tab), - ); + if (hasChartsInScope) { + return isChartInScope; + } - return isChartInScope || isFilterInActiveTab; + return ( + filter.scope?.rootPath?.some(tab => activeTabs.includes(tab)) ?? false + ); }, [selectChartTabParents, activeTabs], ); diff --git a/superset-frontend/src/dashboard/containers/DashboardPage.tsx b/superset-frontend/src/dashboard/containers/DashboardPage.tsx index 28790b0c253..6dd2ebd5256 100644 --- a/superset-frontend/src/dashboard/containers/DashboardPage.tsx +++ b/superset-frontend/src/dashboard/containers/DashboardPage.tsx @@ -223,15 +223,28 @@ export const DashboardPage: FC = ({ idOrSlug }: PageProps) => { // eslint-disable-next-line react-hooks/exhaustive-deps }, [readyToRender]); + // Capture original title before any effects run + const originalTitle = useMemo(() => document.title, []); + + // Update document title when dashboard title changes useEffect(() => { if (dashboard_title) { document.title = dashboard_title; } - return () => { - document.title = 'Superset'; - }; }, [dashboard_title]); + // Restore original title on unmount + useEffect( + () => () => { + document.title = + originalTitle || + theme?.brandAppName || + theme?.brandLogoAlt || + 'Superset'; + }, + [originalTitle, theme?.brandAppName, theme?.brandLogoAlt], + ); + useEffect(() => { if (typeof css === 'string') { // returning will clean up custom css diff --git a/superset-frontend/src/dashboard/reducers/nativeFilters.test.ts b/superset-frontend/src/dashboard/reducers/nativeFilters.test.ts index 65c4e546357..ceac844317b 100644 --- a/superset-frontend/src/dashboard/reducers/nativeFilters.test.ts +++ b/superset-frontend/src/dashboard/reducers/nativeFilters.test.ts @@ -16,7 +16,12 @@ * specific language governing permissions and limitations * under the License. */ -import { Filter, NativeFilterType } from '@superset-ui/core'; +import { + Filter, + NativeFilterType, + ChartCustomization, + ChartCustomizationType, +} from '@superset-ui/core'; import nativeFilterReducer from './nativeFilters'; import { SET_NATIVE_FILTERS_CONFIG_COMPLETE } from '../actions/nativeFilters'; import { HYDRATE_DASHBOARD } from '../actions/hydrate'; @@ -58,6 +63,40 @@ const createMockFilter = ( tabsInScope, }); +const createMockChartCustomization = ( + id: string, + chartsInScope?: number[], + tabsInScope?: string[], +): ChartCustomization => ({ + id, + type: ChartCustomizationType.ChartCustomization, + name: `Chart Customization ${id}`, + filterType: 'filter_select', + targets: [ + { + datasetId: 0, + column: { + name: 'test column', + displayName: 'test column', + }, + }, + ], + scope: { + rootPath: [], + excluded: [], + }, + defaultDataMask: { + filterState: { + value: null, + }, + }, + controlValues: { + sortAscending: true, + }, + chartsInScope, + tabsInScope, +}); + test('SET_NATIVE_FILTERS_CONFIG_COMPLETE updates filters with complete scope properties', () => { const initialState = { filters: { @@ -237,3 +276,142 @@ test('HYDRATE_DASHBOARD handles new filters without existing state', () => { expect(result.filters.filter1.chartsInScope).toEqual([1, 2]); expect(result.filters.filter1.tabsInScope).toEqual(['tab1']); }); + +test('SET_NATIVE_FILTERS_CONFIG_COMPLETE removes deleted filters from state', () => { + const initialState = { + filters: { + filter1: createMockFilter('filter1', [1, 2], ['tab1']), + filter2: createMockFilter('filter2', [3, 4], ['tab2']), + filter3: createMockFilter('filter3', [5, 6], ['tab3']), + }, + }; + + // Backend response only includes filter1 and filter3 (filter2 was deleted) + const action = { + type: SET_NATIVE_FILTERS_CONFIG_COMPLETE as typeof SET_NATIVE_FILTERS_CONFIG_COMPLETE, + filterChanges: [ + createMockFilter('filter1', [1, 2], ['tab1']), + createMockFilter('filter3', [5, 6], ['tab3']), + ], + }; + + const result = nativeFilterReducer(initialState, action); + + // filter2 should be removed from state + expect(result.filters.filter1).toBeDefined(); + expect(result.filters.filter2).toBeUndefined(); + expect(result.filters.filter3).toBeDefined(); + expect(Object.keys(result.filters)).toHaveLength(2); +}); + +test('SET_NATIVE_FILTERS_CONFIG_COMPLETE removes all filters when backend returns empty array', () => { + const initialState = { + filters: { + filter1: createMockFilter('filter1', [1, 2], ['tab1']), + filter2: createMockFilter('filter2', [3, 4], ['tab2']), + }, + }; + + const action = { + type: SET_NATIVE_FILTERS_CONFIG_COMPLETE as typeof SET_NATIVE_FILTERS_CONFIG_COMPLETE, + filterChanges: [], + }; + + const result = nativeFilterReducer(initialState, action); + + expect(Object.keys(result.filters)).toHaveLength(0); + expect(result.filters).toEqual({}); +}); + +test('SET_NATIVE_FILTERS_CONFIG_COMPLETE handles mixed Filter and ChartCustomization types', () => { + const initialState = { + filters: { + filter1: createMockFilter('filter1', [1, 2], ['tab1']), + customization1: createMockChartCustomization( + 'customization1', + [3, 4], + ['tab2'], + ), + }, + }; + + const action = { + type: SET_NATIVE_FILTERS_CONFIG_COMPLETE as typeof SET_NATIVE_FILTERS_CONFIG_COMPLETE, + filterChanges: [ + createMockFilter('filter1', [5, 6], ['tab3']), + createMockChartCustomization('customization1', [7, 8], ['tab4']), + ], + }; + + const result = nativeFilterReducer(initialState, action); + + expect(result.filters.filter1.chartsInScope).toEqual([5, 6]); + expect(result.filters.filter1.tabsInScope).toEqual(['tab3']); + expect(result.filters.customization1.chartsInScope).toEqual([7, 8]); + expect(result.filters.customization1.tabsInScope).toEqual(['tab4']); +}); + +test('SET_NATIVE_FILTERS_CONFIG_COMPLETE adds new filters while removing deleted ones', () => { + const initialState = { + filters: { + filter1: createMockFilter('filter1', [1, 2], ['tab1']), + filter2: createMockFilter('filter2', [3, 4], ['tab2']), + }, + }; + + // Backend response: keep filter1, delete filter2, add filter3 + const action = { + type: SET_NATIVE_FILTERS_CONFIG_COMPLETE as typeof SET_NATIVE_FILTERS_CONFIG_COMPLETE, + filterChanges: [ + createMockFilter('filter1', [1, 2], ['tab1']), + createMockFilter('filter3', [5, 6], ['tab3']), + ], + }; + + const result = nativeFilterReducer(initialState, action); + + expect(result.filters.filter1).toBeDefined(); + expect(result.filters.filter2).toBeUndefined(); + expect(result.filters.filter3).toBeDefined(); + expect(result.filters.filter3.chartsInScope).toEqual([5, 6]); + expect(Object.keys(result.filters)).toHaveLength(2); +}); + +test('SET_NATIVE_FILTERS_CONFIG_COMPLETE treats backend response as source of truth', () => { + const initialState = { + filters: { + filter1: createMockFilter('filter1', [1, 2], ['tab1']), + filter2: createMockFilter('filter2', [3, 4], ['tab2']), + filter3: createMockFilter('filter3', [5, 6], ['tab3']), + customization1: createMockChartCustomization( + 'customization1', + [7, 8], + ['tab4'], + ), + }, + }; + + // Backend only returns filter2 and customization1 + const action = { + type: SET_NATIVE_FILTERS_CONFIG_COMPLETE as typeof SET_NATIVE_FILTERS_CONFIG_COMPLETE, + filterChanges: [ + createMockFilter('filter2', [10, 11], ['tab5']), + createMockChartCustomization('customization1', [12, 13], ['tab6']), + ], + }; + + const result = nativeFilterReducer(initialState, action); + + // Only filter2 and customization1 should remain + expect(result.filters.filter1).toBeUndefined(); + expect(result.filters.filter2).toBeDefined(); + expect(result.filters.filter3).toBeUndefined(); + expect(result.filters.customization1).toBeDefined(); + expect(Object.keys(result.filters)).toHaveLength(2); + + // Values should be from backend response + expect(result.filters.filter2.chartsInScope).toEqual([10, 11]); + expect(result.filters.filter2.tabsInScope).toEqual(['tab5']); + expect(result.filters.customization1.chartsInScope).toEqual([12, 13]); + expect(result.filters.customization1.tabsInScope).toEqual(['tab6']); +}); diff --git a/superset-frontend/src/dashboard/reducers/nativeFilters.ts b/superset-frontend/src/dashboard/reducers/nativeFilters.ts index c1b4c924fa4..37f406dbaf6 100644 --- a/superset-frontend/src/dashboard/reducers/nativeFilters.ts +++ b/superset-frontend/src/dashboard/reducers/nativeFilters.ts @@ -77,13 +77,18 @@ function handleFilterChangesComplete( Filter | Divider | ChartCustomization | ChartCustomizationDivider >, ) { - const modifiedFilters = { ...state.filters }; + // Create new filters object from backend response (deleted filters won't be included) + const newFilters: Record< + string, + Filter | Divider | ChartCustomization | ChartCustomizationDivider + > = {}; + filters.forEach(filter => { + const existingFilter = state.filters[filter.id]; if (filter.chartsInScope != null && filter.tabsInScope != null) { - modifiedFilters[filter.id] = filter; + newFilters[filter.id] = filter; } else { - const existingFilter = modifiedFilters[filter.id]; - modifiedFilters[filter.id] = { + newFilters[filter.id] = { ...filter, chartsInScope: filter.chartsInScope ?? existingFilter?.chartsInScope, tabsInScope: filter.tabsInScope ?? existingFilter?.tabsInScope, @@ -93,7 +98,7 @@ function handleFilterChangesComplete( return { ...state, - filters: modifiedFilters, + filters: newFilters, } as ExtendedNativeFiltersState; } diff --git a/superset-frontend/src/dashboard/util/getChartIdsInFilterScope.test.ts b/superset-frontend/src/dashboard/util/getChartIdsInFilterScope.test.ts new file mode 100644 index 00000000000..07aeb62067b --- /dev/null +++ b/superset-frontend/src/dashboard/util/getChartIdsInFilterScope.test.ts @@ -0,0 +1,370 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, + * software distributed under the License is distributed on an + * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + * KIND, either express or implied. See the License for the + * specific language governing permissions and limitations + * under the License. + */ +import { getChartIdsInFilterScope } from './getChartIdsInFilterScope'; +import { CHART_TYPE } from './componentTypes'; +import { LayoutItem } from '../types'; + +/** + * Creates a minimal valid LayoutItem for testing. + * Only includes fields required by the type and used by getChartIdsInFilterScope. + */ +const createChartLayoutItem = ( + id: string, + chartId: number, + parents: string[], +): LayoutItem => ({ + id, + type: CHART_TYPE, + children: [], + parents, + meta: { + chartId, + height: 100, + width: 100, + uuid: `test-uuid-${id}`, + }, +}); + +const createNestedTabsLayout = (): LayoutItem[] => { + return [ + createChartLayoutItem('CHART-1', 1, [ + 'ROOT_ID', + 'TABS-1', + 'TAB-Parent1', + 'TABS-nested', + 'TAB-P1_Child1', + ]), + createChartLayoutItem('CHART-2', 2, [ + 'ROOT_ID', + 'TABS-1', + 'TAB-Parent1', + 'TABS-nested', + 'TAB-P1_Child1', + ]), + createChartLayoutItem('CHART-3', 3, [ + 'ROOT_ID', + 'TABS-1', + 'TAB-Parent1', + 'TABS-nested', + 'TAB-P1_Child2', + ]), + createChartLayoutItem('CHART-4', 4, [ + 'ROOT_ID', + 'TABS-1', + 'TAB-Parent1', + 'TABS-nested', + 'TAB-P1_Child2', + ]), + createChartLayoutItem('CHART-5', 5, ['ROOT_ID', 'TABS-1', 'TAB-Parent2']), + createChartLayoutItem('CHART-6', 6, ['ROOT_ID', 'TABS-1', 'TAB-Parent2']), + ]; +}; + +const allChartIds = [1, 2, 3, 4, 5, 6]; + +test('filter scoped to all panels should include all charts', () => { + const chartLayoutItems = createNestedTabsLayout(); + const filterScope = { + rootPath: ['ROOT_ID'], + excluded: [], + }; + + const chartsInScope = getChartIdsInFilterScope( + filterScope, + allChartIds, + chartLayoutItems, + ); + + expect(chartsInScope.sort()).toEqual([1, 2, 3, 4, 5, 6]); +}); + +test('filter scoped to Parent1 tab should include only charts in Parent1 (including nested tabs)', () => { + const chartLayoutItems = createNestedTabsLayout(); + const filterScope = { + rootPath: ['TAB-Parent1'], + excluded: [], + }; + + const chartsInScope = getChartIdsInFilterScope( + filterScope, + allChartIds, + chartLayoutItems, + ); + + expect(chartsInScope.sort()).toEqual([1, 2, 3, 4]); +}); + +test('filter scoped to Parent2 tab should include only charts in Parent2', () => { + const chartLayoutItems = createNestedTabsLayout(); + const filterScope = { + rootPath: ['TAB-Parent2'], + excluded: [], + }; + + const chartsInScope = getChartIdsInFilterScope( + filterScope, + allChartIds, + chartLayoutItems, + ); + + expect(chartsInScope.sort()).toEqual([5, 6]); +}); + +test('filter scoped to P1_Child1 nested tab should include only charts in that tab', () => { + const chartLayoutItems = createNestedTabsLayout(); + const filterScope = { + rootPath: ['TAB-P1_Child1'], + excluded: [], + }; + + const chartsInScope = getChartIdsInFilterScope( + filterScope, + allChartIds, + chartLayoutItems, + ); + + expect(chartsInScope.sort()).toEqual([1, 2]); +}); + +test('filter excluding P1_Child2 tab should not include charts 3 and 4', () => { + const chartLayoutItems = createNestedTabsLayout(); + const filterScope = { + rootPath: ['TAB-P1_Child1', 'TAB-Parent2'], + excluded: [3, 4], + }; + + const chartsInScope = getChartIdsInFilterScope( + filterScope, + allChartIds, + chartLayoutItems, + ); + + expect(chartsInScope.sort()).toEqual([1, 2, 5, 6]); +}); + +test('filter with ROOT_ID rootPath excluding charts 3 and 4 should work correctly', () => { + const chartLayoutItems = createNestedTabsLayout(); + const filterScope = { + rootPath: ['ROOT_ID'], + excluded: [3, 4], + }; + + const chartsInScope = getChartIdsInFilterScope( + filterScope, + allChartIds, + chartLayoutItems, + ); + + expect(chartsInScope.sort()).toEqual([1, 2, 5, 6]); +}); + +test('filter scoped to multiple top-level tabs should include charts from all specified tabs', () => { + const chartLayoutItems = createNestedTabsLayout(); + const filterScope = { + rootPath: ['TAB-Parent1', 'TAB-Parent2'], + excluded: [], + }; + + const chartsInScope = getChartIdsInFilterScope( + filterScope, + allChartIds, + chartLayoutItems, + ); + + expect(chartsInScope.sort()).toEqual([1, 2, 3, 4, 5, 6]); +}); + +test('filter scoped to nested tab with exclusion should work', () => { + const chartLayoutItems = createNestedTabsLayout(); + const filterScope = { + rootPath: ['TAB-P1_Child1'], + excluded: [2], + }; + + const chartsInScope = getChartIdsInFilterScope( + filterScope, + allChartIds, + chartLayoutItems, + ); + + expect(chartsInScope).toEqual([1]); +}); + +test('filter with selectedLayers should include charts from layer selections', () => { + const chartLayoutItems = createNestedTabsLayout(); + const filterScope = { + rootPath: ['ROOT_ID'], + excluded: [], + selectedLayers: ['chart-1-layer-0', 'chart-2-layer-1'], + }; + + const chartsInScope = getChartIdsInFilterScope( + filterScope, + allChartIds, + chartLayoutItems, + ); + + expect(chartsInScope.sort()).toEqual([1, 2, 3, 4, 5, 6]); +}); + +test('filter with selectedLayers should include both layer-selected charts and regular charts', () => { + const chartLayoutItems = createNestedTabsLayout(); + const filterScope = { + rootPath: ['TAB-Parent2'], + excluded: [], + selectedLayers: ['chart-1-layer-0'], + }; + + const chartsInScope = getChartIdsInFilterScope( + filterScope, + allChartIds, + chartLayoutItems, + ); + + expect(chartsInScope.sort()).toEqual([1, 5, 6]); +}); + +test('filter with selectedLayers should exclude charts that have layer selections from regular filtering', () => { + const chartLayoutItems = createNestedTabsLayout(); + const filterScope = { + rootPath: ['TAB-P1_Child1'], + excluded: [], + selectedLayers: ['chart-1-layer-0'], + }; + + const chartsInScope = getChartIdsInFilterScope( + filterScope, + allChartIds, + chartLayoutItems, + ); + + expect(chartsInScope.sort()).toEqual([1, 2]); +}); + +test('filter with selectedLayers should ignore invalid layer key formats', () => { + const chartLayoutItems = createNestedTabsLayout(); + const filterScope = { + rootPath: ['ROOT_ID'], + excluded: [], + selectedLayers: [ + 'chart-1-layer-0', + 'invalid-format', + 'chart-2-layer-1', + 'chart-invalid-layer-0', + ], + }; + + const chartsInScope = getChartIdsInFilterScope( + filterScope, + allChartIds, + chartLayoutItems, + ); + + expect(chartsInScope.sort()).toEqual([1, 2, 3, 4, 5, 6]); +}); + +test('filter with selectedLayers should handle charts not in chartIds array', () => { + const chartLayoutItems = createNestedTabsLayout(); + const filterScope = { + rootPath: ['ROOT_ID'], + excluded: [], + selectedLayers: ['chart-1-layer-0', 'chart-999-layer-0'], + }; + + const chartsInScope = getChartIdsInFilterScope( + filterScope, + allChartIds, + chartLayoutItems, + ); + + expect(chartsInScope.sort()).toEqual([1, 2, 3, 4, 5, 6]); +}); + +test('filter with selectedLayers should deduplicate chart IDs', () => { + const chartLayoutItems = createNestedTabsLayout(); + const filterScope = { + rootPath: ['ROOT_ID'], + excluded: [], + selectedLayers: [ + 'chart-1-layer-0', + 'chart-1-layer-1', + 'chart-2-layer-0', + 'chart-2-layer-2', + ], + }; + + const chartsInScope = getChartIdsInFilterScope( + filterScope, + allChartIds, + chartLayoutItems, + ); + + expect(chartsInScope.sort()).toEqual([1, 2, 3, 4, 5, 6]); +}); + +test('filter with selectedLayers and rootPath should combine both correctly', () => { + const chartLayoutItems = createNestedTabsLayout(); + const filterScope = { + rootPath: ['TAB-Parent2'], + excluded: [], + selectedLayers: ['chart-1-layer-0'], + }; + + const chartsInScope = getChartIdsInFilterScope( + filterScope, + allChartIds, + chartLayoutItems, + ); + + expect(chartsInScope.sort()).toEqual([1, 5, 6]); +}); + +test('filter with selectedLayers should include charts even if they are in excluded array', () => { + const chartLayoutItems = createNestedTabsLayout(); + const filterScope = { + rootPath: ['ROOT_ID'], + excluded: [1, 2], + selectedLayers: ['chart-1-layer-0', 'chart-2-layer-0'], + }; + + const chartsInScope = getChartIdsInFilterScope( + filterScope, + allChartIds, + chartLayoutItems, + ); + + expect(chartsInScope.sort()).toEqual([1, 2, 3, 4, 5, 6]); +}); + +test('filter with selectedLayers and excluded should exclude regular charts but include layer-selected charts', () => { + const chartLayoutItems = createNestedTabsLayout(); + const filterScope = { + rootPath: ['TAB-Parent2'], + excluded: [5], + selectedLayers: ['chart-1-layer-0'], + }; + + const chartsInScope = getChartIdsInFilterScope( + filterScope, + allChartIds, + chartLayoutItems, + ); + + expect(chartsInScope.sort()).toEqual([1, 6]); +}); diff --git a/superset-frontend/src/explore/components/DataTableControl/index.tsx b/superset-frontend/src/explore/components/DataTableControl/index.tsx index 3cb98afe41a..7f010de6176 100644 --- a/superset-frontend/src/explore/components/DataTableControl/index.tsx +++ b/superset-frontend/src/explore/components/DataTableControl/index.tsx @@ -164,6 +164,7 @@ const DataTableTemporalHeaderCell = ({ onTimeColumnChange, datasourceId, isOriginalTimeColumn, + displayLabel, }: { columnName: string; onTimeColumnChange: ( @@ -172,6 +173,7 @@ const DataTableTemporalHeaderCell = ({ ) => void; datasourceId?: string; isOriginalTimeColumn: boolean; + displayLabel?: string; }) => { const theme = useTheme(); @@ -215,10 +217,10 @@ const DataTableTemporalHeaderCell = ({ onClick={(e: React.MouseEvent) => e.stopPropagation()} /> - {columnName} + {displayLabel ?? columnName} ) : ( - {columnName} + {displayLabel ?? columnName} ); }; @@ -258,6 +260,7 @@ export const useTableColumns = ( isVisible?: boolean, moreConfigs?: { [key: string]: Partial }, allowHTML?: boolean, + columnDisplayNames?: Record, ) => { const [originalFormattedTimeColumns, setOriginalFormattedTimeColumns] = useState(getTimeColumns(datasourceId)); @@ -302,6 +305,7 @@ export const useTableColumns = ( .map((key, index) => { const colType = coltypes?.[index]; const firstValue = data[0][key]; + const headerLabel = columnDisplayNames?.[key] ?? key; const originalFormattedTimeColumnIndex = colType === GenericDataType.Temporal ? originalFormattedTimeColumns.indexOf(key) @@ -320,9 +324,10 @@ export const useTableColumns = ( datasourceId={datasourceId} onTimeColumnChange={onTimeColumnChange} isOriginalTimeColumn={isOriginalTimeColumn} + displayLabel={headerLabel} /> ) : ( - key + headerLabel ), Cell: ({ value }) => { if (value === true) { @@ -357,6 +362,7 @@ export const useTableColumns = ( datasourceId, moreConfigs, originalFormattedTimeColumns, + columnDisplayNames, ], ); }; diff --git a/superset-frontend/src/explore/components/DataTableControl/useTableColumns.test.ts b/superset-frontend/src/explore/components/DataTableControl/useTableColumns.test.ts index b9defabc28f..acfb4987879 100644 --- a/superset-frontend/src/explore/components/DataTableControl/useTableColumns.test.ts +++ b/superset-frontend/src/explore/components/DataTableControl/useTableColumns.test.ts @@ -105,6 +105,7 @@ test('useTableColumns with no options', () => { "Cell": [Function], "Header": , @@ -168,6 +169,7 @@ test('useTableColumns with options', () => { "Cell": [Function], "Header": , @@ -194,3 +196,29 @@ test('useTableColumns with options', () => { }); }); }); + +test('useTableColumns applies columnDisplayNames to headers', () => { + const columnDisplayNames = { + col01: 'Column One', + [NUMTIME_KEY]: 'Verbose Numtime', + } as Record; + const hook = renderHook(() => + useTableColumns( + colnames, + coltypes, + data, + undefined, + true, + undefined, + undefined, + columnDisplayNames, + ), + ); + const cols = hook.result.current as JsonObject[]; + const col01 = cols.find(c => c.id === 'col01'); + const numtime = cols.find(c => c.id === NUMTIME_KEY); + expect(col01?.Header).toBe('Column One'); + // Temporal header is a component; ensure it received the displayLabel prop + // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access + expect(numtime?.Header.props.displayLabel).toBe('Verbose Numtime'); +}); diff --git a/superset-frontend/src/explore/components/DataTablesPane/components/ResultsPaneOnDashboard.tsx b/superset-frontend/src/explore/components/DataTablesPane/components/ResultsPaneOnDashboard.tsx index 0883505b193..196bed0b1d9 100644 --- a/superset-frontend/src/explore/components/DataTablesPane/components/ResultsPaneOnDashboard.tsx +++ b/superset-frontend/src/explore/components/DataTablesPane/components/ResultsPaneOnDashboard.tsx @@ -55,6 +55,7 @@ export const ResultsPaneOnDashboard = ({ isVisible, dataSize = 50, canDownload, + columnDisplayNames, }: ResultsPaneProps) => { const resultsPanes = useResultsPane({ errorMessage, @@ -66,6 +67,7 @@ export const ResultsPaneOnDashboard = ({ dataSize, isVisible, canDownload, + columnDisplayNames, }); if (resultsPanes.length === 1) { diff --git a/superset-frontend/src/explore/components/DataTablesPane/components/SingleQueryResultPane.tsx b/superset-frontend/src/explore/components/DataTablesPane/components/SingleQueryResultPane.tsx index 73fa093bec5..562f5cc9eb7 100644 --- a/superset-frontend/src/explore/components/DataTablesPane/components/SingleQueryResultPane.tsx +++ b/superset-frontend/src/explore/components/DataTablesPane/components/SingleQueryResultPane.tsx @@ -39,6 +39,7 @@ export const SingleQueryResultPane = ({ dataSize = 50, isVisible, canDownload, + columnDisplayNames, }: SingleQueryResultPaneProp) => { const [filterText, setFilterText] = useState(''); @@ -52,6 +53,7 @@ export const SingleQueryResultPane = ({ isVisible, {}, // moreConfig true, // allowHTML + columnDisplayNames, ); const filteredData = useFilteredTableData(filterText, data); diff --git a/superset-frontend/src/explore/components/DataTablesPane/components/useResultsPane.tsx b/superset-frontend/src/explore/components/DataTablesPane/components/useResultsPane.tsx index 143a07e0148..5372fd11852 100644 --- a/superset-frontend/src/explore/components/DataTablesPane/components/useResultsPane.tsx +++ b/superset-frontend/src/explore/components/DataTablesPane/components/useResultsPane.tsx @@ -55,6 +55,7 @@ export const useResultsPane = ({ isVisible, dataSize = 50, canDownload, + columnDisplayNames, }: ResultsPaneProps): ReactElement[] => { const metadata = getChartMetadataRegistry().get( queryFormData?.viz_type || queryFormData?.vizType, @@ -164,6 +165,7 @@ export const useResultsPane = ({ datasourceId={queryFormData.datasource} isVisible={isVisible} canDownload={canDownload} + columnDisplayNames={columnDisplayNames} /> )); diff --git a/superset-frontend/src/explore/components/DataTablesPane/types.ts b/superset-frontend/src/explore/components/DataTablesPane/types.ts index 7a4764974b5..d5b6891ec99 100644 --- a/superset-frontend/src/explore/components/DataTablesPane/types.ts +++ b/superset-frontend/src/explore/components/DataTablesPane/types.ts @@ -49,6 +49,8 @@ export interface ResultsPaneProps { // reload OriginalFormattedTimeColumns from localStorage when isVisible is true isVisible: boolean; canDownload: boolean; + // Optional map of column/metric name -> verbose label + columnDisplayNames?: Record; } export interface SamplesPaneProps { @@ -88,4 +90,6 @@ export interface SingleQueryResultPaneProp extends QueryResultInterface { // reload OriginalFormattedTimeColumns from localStorage when isVisible is true isVisible: boolean; canDownload: boolean; + // Optional map of column/metric name -> verbose label + columnDisplayNames?: Record; } diff --git a/superset-frontend/src/explore/components/ExploreViewContainer/index.jsx b/superset-frontend/src/explore/components/ExploreViewContainer/index.jsx index f8556a19ce3..03cea2fa0a1 100644 --- a/superset-frontend/src/explore/components/ExploreViewContainer/index.jsx +++ b/superset-frontend/src/explore/components/ExploreViewContainer/index.jsx @@ -291,15 +291,28 @@ function ExploreViewContainer(props) { const theme = useTheme(); + // Capture original title before any effects run + const originalTitle = useMemo(() => document.title, []); + + // Update document title when slice name changes useEffect(() => { if (props.sliceName) { document.title = props.sliceName; } - return () => { - document.title = 'Superset'; - }; }, [props.sliceName]); + // Restore original title on unmount + useEffect( + () => () => { + document.title = + originalTitle || + theme?.brandAppName || + theme?.brandLogoAlt || + 'Superset'; + }, + [originalTitle, theme?.brandAppName, theme?.brandLogoAlt], + ); + const addHistory = useCallback( async ({ isReplace = false, title } = {}) => { const formData = props.dashboardId diff --git a/superset-frontend/src/explore/components/SaveModal.tsx b/superset-frontend/src/explore/components/SaveModal.tsx index 67284fcd97b..3b70e70a3ad 100644 --- a/superset-frontend/src/explore/components/SaveModal.tsx +++ b/superset-frontend/src/explore/components/SaveModal.tsx @@ -320,7 +320,7 @@ class SaveModal extends Component { // Go to new dashboard url if (gotodash && dashboard) { - let url = dashboard.url; + let { url } = dashboard; if (this.state.selectedTab?.value) { url += `#${this.state.selectedTab.value}`; } diff --git a/superset-frontend/src/explore/components/controls/DateFilterControl/tests/DateFilterLabel.test.tsx b/superset-frontend/src/explore/components/controls/DateFilterControl/tests/DateFilterLabel.test.tsx index f4c36bfa174..1a88d1da843 100644 --- a/superset-frontend/src/explore/components/controls/DateFilterControl/tests/DateFilterLabel.test.tsx +++ b/superset-frontend/src/explore/components/controls/DateFilterControl/tests/DateFilterLabel.test.tsx @@ -93,3 +93,46 @@ test('Open and close popover', () => { expect(defaultProps.onClosePopover).toHaveBeenCalled(); expect(screen.queryByText('Edit time range')).not.toBeInTheDocument(); }); + +test('DateFilter popover should attach to document.body when not overflowing', () => { + render(setup({ ...defaultProps, isOverflowingFilterBar: false })); + + userEvent.click(screen.getByText(NO_TIME_RANGE)); + + const popover = document.querySelector('.time-range-popover'); + expect(popover?.parentElement).toBe(document.body); +}); + +test('DateFilter popover should attach to parent node when overflowing in filter bar', () => { + render(setup({ ...defaultProps, isOverflowingFilterBar: true })); + + userEvent.click(screen.getByText(NO_TIME_RANGE)); + + const popover = document.querySelector('.time-range-popover'); + const trigger = screen.getByTestId(DateFilterTestKey.PopoverOverlay); + + expect(popover?.parentElement).toBe(trigger.parentElement); +}); + +test('DateFilter should properly handle isOverflowingFilterBar prop changes', () => { + const { rerender } = render( + setup({ ...defaultProps, isOverflowingFilterBar: false }), + ); + + // When not overflowing, popover should attach to document.body + userEvent.click(screen.getByText(NO_TIME_RANGE)); + const popover = document.querySelector('.time-range-popover'); + expect(popover?.parentElement).toBe(document.body); + + userEvent.click(screen.getByText('CANCEL')); + + // When overflowing, popover should attach to parent node + rerender(setup({ ...defaultProps, isOverflowingFilterBar: true })); + userEvent.click(screen.getByText(NO_TIME_RANGE)); + + const popoverAfterRerender = document.querySelector('.time-range-popover'); + const trigger = screen.getByTestId(DateFilterTestKey.PopoverOverlay); + + expect(popoverAfterRerender?.parentElement).toBe(trigger.parentElement); + expect(popoverAfterRerender?.parentElement).not.toBe(document.body); +}); diff --git a/superset-frontend/src/explore/components/controls/ViewportControl.test.tsx b/superset-frontend/src/explore/components/controls/ViewportControl.test.tsx index ee227fc9072..488149f971d 100644 --- a/superset-frontend/src/explore/components/controls/ViewportControl.test.tsx +++ b/superset-frontend/src/explore/components/controls/ViewportControl.test.tsx @@ -30,7 +30,7 @@ const defaultProps = { name: 'foo', label: 'bar', }; -const renderedCoordinate = '6° 51\' 8.50" | 31° 13\' 21.56"'; +const renderedCoordinate = '6° 51\' 08.5017" | 31° 13\' 21.5646"'; // eslint-disable-next-line no-restricted-globals -- TODO: Migrate from describe blocks describe('ViewportControl', () => { diff --git a/superset-frontend/src/explore/components/controls/ViewportControl.tsx b/superset-frontend/src/explore/components/controls/ViewportControl.tsx index 442ef7174f9..9ae1b1169a4 100644 --- a/superset-frontend/src/explore/components/controls/ViewportControl.tsx +++ b/superset-frontend/src/explore/components/controls/ViewportControl.tsx @@ -19,7 +19,7 @@ import { Component, type ReactNode } from 'react'; import { t } from '@apache-superset/core'; import { Popover, FormLabel, Label } from '@superset-ui/core/components'; -import { decimal2sexagesimal } from 'geolib'; +import { decimalToSexagesimal } from 'geolib'; import TextControl from './TextControl'; import ControlHeader from '../ControlHeader'; @@ -92,9 +92,9 @@ export default class ViewportControl extends Component { renderLabel(): string { if (this.props.value?.longitude && this.props.value?.latitude) { - return `${decimal2sexagesimal( + return `${decimalToSexagesimal( this.props.value.longitude, - )} | ${decimal2sexagesimal(this.props.value.latitude)}`; + )} | ${decimalToSexagesimal(this.props.value.latitude)}`; } return 'N/A'; } diff --git a/superset-frontend/src/explore/components/controls/VizTypeControl/FastVizSwitcher.tsx b/superset-frontend/src/explore/components/controls/VizTypeControl/FastVizSwitcher.tsx index 78556970f4c..77c8969743e 100644 --- a/superset-frontend/src/explore/components/controls/VizTypeControl/FastVizSwitcher.tsx +++ b/superset-frontend/src/explore/components/controls/VizTypeControl/FastVizSwitcher.tsx @@ -24,7 +24,7 @@ import { getChartKey } from 'src/explore/exploreUtils'; import { ExplorePageState } from 'src/explore/types'; import { FastVizSwitcherProps } from './types'; import { VizTile } from './VizTile'; -import { FEATURED_CHARTS } from './constants'; +import { FEATURED_CHARTS, CUSTOM_CHART_ICONS } from './constants'; export const antdIconProps = { iconSize: 'l' as const, @@ -54,7 +54,7 @@ export const FastVizSwitcher = memo( ) { vizTiles.unshift({ name: currentSelection, - icon: ( + icon: CUSTOM_CHART_ICONS[currentSelection] || ( ), }); @@ -67,7 +67,7 @@ export const FastVizSwitcher = memo( ) { vizTiles.unshift({ name: currentViz, - icon: ( + icon: CUSTOM_CHART_ICONS[currentViz] || ( { expect(screen.getByLabelText('area-chart')).toBeVisible(); expect(screen.queryByLabelText('monitor')).not.toBeInTheDocument(); expect(screen.queryByLabelText('check-square')).not.toBeInTheDocument(); + // Multi Chart should NOT appear when other charts are selected + expect(screen.queryByLabelText('multiple')).not.toBeInTheDocument(); expect( within(screen.getByTestId('fast-viz-switcher')).getByText('Line Chart'), @@ -150,6 +154,31 @@ describe('VizTypeControl', () => { expect( within(screen.getByTestId('fast-viz-switcher')).getByText('Area Chart'), ).toBeInTheDocument(); + // Multi Chart text should NOT appear when Line Chart is selected + expect( + within(screen.getByTestId('fast-viz-switcher')).queryByText( + 'deck.gl Multiple Layers', + ), + ).not.toBeInTheDocument(); + }); + + test('Multi Chart appears with custom icon when selected', async () => { + const props = { + ...defaultProps, + value: 'deck_multi', + isModalOpenInit: false, + }; + await waitForRenderWrapper(props); + + // Multi Chart icon should be visible when deck_multi is selected + expect(screen.getByLabelText('multiple')).toBeVisible(); + expect( + within(screen.getByTestId('fast-viz-switcher')).getByText( + 'deck.gl Multiple Layers', + ), + ).toBeInTheDocument(); + // Should not show the generic check-square icon + expect(screen.queryByLabelText('check-square')).not.toBeInTheDocument(); }); test('Render viz tiles when non-featured chart is selected', async () => { diff --git a/superset-frontend/src/explore/components/controls/VizTypeControl/constants.tsx b/superset-frontend/src/explore/components/controls/VizTypeControl/constants.tsx index 930928f8ed4..01c1d69ebb9 100644 --- a/superset-frontend/src/explore/components/controls/VizTypeControl/constants.tsx +++ b/superset-frontend/src/explore/components/controls/VizTypeControl/constants.tsx @@ -16,11 +16,17 @@ * specific language governing permissions and limitations * under the License. */ +import { ReactElement } from 'react'; import { VizType } from '@superset-ui/core'; import { css } from '@apache-superset/core/ui'; import { Icons } from '@superset-ui/core/components/Icons'; import { VizMeta } from './types'; +// Custom icons for non-featured charts +export const CUSTOM_CHART_ICONS: Record = { + deck_multi: , +}; + export const FEATURED_CHARTS: VizMeta[] = [ { name: VizType.Line, diff --git a/superset-frontend/src/explore/exploreUtils/index.js b/superset-frontend/src/explore/exploreUtils/index.js index 1ebde5a3783..e7df0249998 100644 --- a/superset-frontend/src/explore/exploreUtils/index.js +++ b/superset-frontend/src/explore/exploreUtils/index.js @@ -78,21 +78,24 @@ export function getAnnotationJsonUrl(slice_id, force) { .toString(); } -export function getURIDirectory(endpointType = 'base') { +export function getURIDirectory(endpointType = 'base', includeAppRoot = true) { // Building the directory part of the URI - if ( - ['full', 'json', 'csv', 'query', 'results', 'samples'].includes( - endpointType, - ) - ) { - return ensureAppRoot('/superset/explore_json/'); - } - return ensureAppRoot('/explore/'); + const uri = ['full', 'json', 'csv', 'query', 'results', 'samples'].includes( + endpointType, + ) + ? '/superset/explore_json/' + : '/explore/'; + return includeAppRoot ? ensureAppRoot(uri) : uri; } -export function mountExploreUrl(endpointType, extraSearch = {}, force = false) { +export function mountExploreUrl( + endpointType, + extraSearch = {}, + force = false, + includeAppRoot = true, +) { const uri = new URI('/'); - const directory = getURIDirectory(endpointType); + const directory = getURIDirectory(endpointType, includeAppRoot); const search = uri.search(true); Object.keys(extraSearch).forEach(key => { search[key] = extraSearch[key]; diff --git a/superset-frontend/src/features/datasets/AddDataset/LeftPanel/index.tsx b/superset-frontend/src/features/datasets/AddDataset/LeftPanel/index.tsx index fec2e106e1e..8e3b2a006eb 100644 --- a/superset-frontend/src/features/datasets/AddDataset/LeftPanel/index.tsx +++ b/superset-frontend/src/features/datasets/AddDataset/LeftPanel/index.tsx @@ -30,6 +30,7 @@ import { } from 'src/features/datasets/AddDataset/types'; import { Table } from 'src/hooks/apiResources'; import { Typography } from '@superset-ui/core/components/Typography'; +import { ensureAppRoot } from 'src/utils/pathUtils'; interface LeftPanelProps { setDataset: Dispatch>; @@ -191,7 +192,7 @@ export default function LeftPanel({ description={ {t('Manage your databases')}{' '} - + {t('here')} diff --git a/superset-frontend/src/features/home/Menu.test.tsx b/superset-frontend/src/features/home/Menu.test.tsx index 4dd01c66e1b..4b7e744188e 100644 --- a/superset-frontend/src/features/home/Menu.test.tsx +++ b/superset-frontend/src/features/home/Menu.test.tsx @@ -22,6 +22,7 @@ import { render, screen, userEvent } from 'spec/helpers/testing-library'; import setupCodeOverrides from 'src/setup/setupCodeOverrides'; import { getExtensionsRegistry } from '@superset-ui/core'; import { Menu } from './Menu'; +import * as getBootstrapData from 'src/utils/getBootstrapData'; const dropdownItems = [ { @@ -238,6 +239,10 @@ const notanonProps = { }; const useSelectorMock = jest.spyOn(reactRedux, 'useSelector'); +const staticAssetsPrefixMock = jest.spyOn( + getBootstrapData, + 'staticAssetsPrefix', +); fetchMock.get( 'glob:*api/v1/database/?q=(filters:!((col:allow_file_upload,opr:upload_is_enabled,value:!t)))', @@ -247,6 +252,8 @@ fetchMock.get( beforeEach(() => { // setup a DOM element as a render target useSelectorMock.mockClear(); + // By default use empty static assets prefix + staticAssetsPrefixMock.mockReturnValue(''); }); test('should render', async () => { @@ -272,23 +279,27 @@ test('should render the navigation', async () => { expect(await screen.findByRole('navigation')).toBeInTheDocument(); }); -test('should render the brand', async () => { - useSelectorMock.mockReturnValue({ roles: user.roles }); - const { - data: { - brand: { alt, icon }, - }, - } = mockedProps; - render(, { - useRedux: true, - useQueryParams: true, - useRouter: true, - useTheme: true, - }); - expect(await screen.findByAltText(alt)).toBeInTheDocument(); - const image = screen.getByAltText(alt); - expect(image).toHaveAttribute('src', icon); -}); +test.each(['', '/myapp'])( + 'should render the brand, including app_root "%s"', + async app_root => { + staticAssetsPrefixMock.mockReturnValue(app_root); + useSelectorMock.mockReturnValue({ roles: user.roles }); + const { + data: { + brand: { alt, icon }, + }, + } = mockedProps; + render(, { + useRedux: true, + useQueryParams: true, + useRouter: true, + useTheme: true, + }); + expect(await screen.findByAltText(alt)).toBeInTheDocument(); + const image = screen.getByAltText(alt); + expect(image).toHaveAttribute('src', `${app_root}${icon}`); + }, +); test('should render the environment tag', async () => { useSelectorMock.mockReturnValue({ roles: user.roles }); diff --git a/superset-frontend/src/features/home/Menu.tsx b/superset-frontend/src/features/home/Menu.tsx index 9d8c35341bb..96270b03ecc 100644 --- a/superset-frontend/src/features/home/Menu.tsx +++ b/superset-frontend/src/features/home/Menu.tsx @@ -18,6 +18,8 @@ */ import { useState, useEffect } from 'react'; import { styled, css, useTheme } from '@apache-superset/core/ui'; +import { ensureStaticPrefix } from 'src/utils/assetUrl'; +import { ensureAppRoot } from 'src/utils/pathUtils'; import { getUrlParam } from 'src/utils/urlUtils'; import { MainNav, MenuItem } from '@superset-ui/core/components/Menu'; import { Tooltip, Grid, Row, Col, Image } from '@superset-ui/core/components'; @@ -287,10 +289,10 @@ export function Menu({ if (theme.brandLogoUrl) { link = ( - + @@ -303,17 +305,25 @@ export function Menu({ // Kept as is for backwards compatibility with the old theme system / superset_config.py link = ( - + ); } else { link = ( - + ); } diff --git a/superset-frontend/src/features/home/RightMenu.tsx b/superset-frontend/src/features/home/RightMenu.tsx index 05a7d0f85a6..dcca12f0304 100644 --- a/superset-frontend/src/features/home/RightMenu.tsx +++ b/superset-frontend/src/features/home/RightMenu.tsx @@ -483,7 +483,7 @@ const RightMenu = ({ userItems.push({ key: 'info', label: ( - + {t('Info')} ), diff --git a/superset-frontend/src/hooks/apiResources/tables.ts b/superset-frontend/src/hooks/apiResources/tables.ts index 81792b4a522..99fc568d1f0 100644 --- a/superset-frontend/src/hooks/apiResources/tables.ts +++ b/superset-frontend/src/hooks/apiResources/tables.ts @@ -17,6 +17,7 @@ * under the License. */ import { useCallback, useMemo, useEffect, useRef } from 'react'; +import { ClientErrorObject } from '@superset-ui/core'; import useEffectEvent from 'src/hooks/useEffectEvent'; import { toQueryString } from 'src/utils/urlUtils'; import { api, JsonResponse } from './queryApi'; @@ -55,7 +56,7 @@ export type FetchTablesQueryParams = { schema?: string; forceRefresh?: boolean; onSuccess?: (data: Data, isRefetched: boolean) => void; - onError?: (error: Response) => void; + onError?: (error: ClientErrorObject) => void; }; export type FetchTableMetadataQueryParams = { @@ -192,7 +193,7 @@ export function useTables(options: Params) { onSuccess?.(data, isRefetched); }); - const handleOnError = useEffectEvent((error: Response) => { + const handleOnError = useEffectEvent((error: ClientErrorObject) => { onError?.(error); }); @@ -204,7 +205,7 @@ export function useTables(options: Params) { handleOnSuccess(data, true); } if (isError) { - handleOnError(error as Response); + handleOnError(error as ClientErrorObject); } }, ); @@ -227,7 +228,7 @@ export function useTables(options: Params) { handleOnSuccess(currentData, false); } if (isError) { - handleOnError(error as Response); + handleOnError(error as ClientErrorObject); } } } else { diff --git a/superset-frontend/src/pages/SqlLab/LocationContext.tsx b/superset-frontend/src/pages/SqlLab/LocationContext.tsx index 6574cd664c2..de9539c2f7d 100644 --- a/superset-frontend/src/pages/SqlLab/LocationContext.tsx +++ b/superset-frontend/src/pages/SqlLab/LocationContext.tsx @@ -40,13 +40,14 @@ export const LocationProvider: FC = ({ children }: { children: ReactNode }) => { const permalink = location.pathname.match(/\/p\/\w+/)?.[0].slice(3); if (queryParams.size > 0 || permalink) { const autorun = queryParams.get('autorun') === 'true'; + const isDataset = queryParams.get('isDataset') === 'true'; const queryParamsState = { requestedQuery: { ...Object.fromEntries(queryParams), autorun, permalink, }, - isDataset: true, + isDataset, } as LocationState; return {children}; } diff --git a/superset-frontend/src/utils/assetUrl.test.ts b/superset-frontend/src/utils/assetUrl.test.ts new file mode 100644 index 00000000000..ac501899b7a --- /dev/null +++ b/superset-frontend/src/utils/assetUrl.test.ts @@ -0,0 +1,48 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, + * software distributed under the License is distributed on an + * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + * KIND, either express or implied. See the License for the + * specific language governing permissions and limitations + * under the License. + */ +import * as getBootstrapData from 'src/utils/getBootstrapData'; +import { assetUrl, ensureStaticPrefix } from './assetUrl'; + +const staticAssetsPrefixMock = jest.spyOn( + getBootstrapData, + 'staticAssetsPrefix', +); +const resourcePath = '/endpoint/img.png'; +const absoluteResourcePath = `https://cdn.domain.com/static${resourcePath}`; + +beforeEach(() => { + staticAssetsPrefixMock.mockReturnValue(''); +}); + +describe('assetUrl should prepend static asset prefix for relative paths', () => { + it.each(['', '/myapp'])("'%s' for relative path", app_root => { + staticAssetsPrefixMock.mockReturnValue(app_root); + expect(assetUrl(resourcePath)).toBe(`${app_root}${resourcePath}`); + expect(assetUrl(absoluteResourcePath)).toBe( + `${app_root}/${absoluteResourcePath}`, + ); + }); +}); + +describe('assetUrl should ignore static asset prefix for absolute URLs', () => { + it.each(['', '/myapp'])("'%s' for absolute url", app_root => { + staticAssetsPrefixMock.mockReturnValue(app_root); + expect(ensureStaticPrefix(absoluteResourcePath)).toBe(absoluteResourcePath); + }); +}); diff --git a/superset-frontend/src/utils/assetUrl.ts b/superset-frontend/src/utils/assetUrl.ts index 5e834527838..a7fc2553b50 100644 --- a/superset-frontend/src/utils/assetUrl.ts +++ b/superset-frontend/src/utils/assetUrl.ts @@ -23,6 +23,17 @@ import { staticAssetsPrefix } from 'src/utils/getBootstrapData'; * defined in the bootstrap data * @param path A string path to a resource */ -export function assetUrl(path: string) { +export function assetUrl(path: string): string { return `${staticAssetsPrefix()}${path.startsWith('/') ? path : `/${path}`}`; } + +/** + * Returns the path prepended with the staticAssetsPrefix if the string is a relative path else it returns + * the string as is. + * @param url_or_path A url or relative path to a resource + */ +export function ensureStaticPrefix(url_or_path: string): string { + if (url_or_path.startsWith('/')) return assetUrl(url_or_path); + + return url_or_path; +} diff --git a/superset-websocket/.nvmrc b/superset-websocket/.nvmrc index 4a207c55991..42a1c98ac5a 100644 --- a/superset-websocket/.nvmrc +++ b/superset-websocket/.nvmrc @@ -1 +1 @@ -v20.18.3 +v22.22.0 diff --git a/superset-websocket/Dockerfile b/superset-websocket/Dockerfile index ac6e4a29993..e9aabd124fa 100644 --- a/superset-websocket/Dockerfile +++ b/superset-websocket/Dockerfile @@ -12,7 +12,7 @@ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. -FROM node:16-alpine AS build +FROM node:22-alpine AS build WORKDIR /home/superset-websocket @@ -22,7 +22,7 @@ RUN npm ci && \ npm run build -FROM node:16-alpine +FROM node:22-alpine ENV NODE_ENV=production WORKDIR /home/superset-websocket diff --git a/superset-websocket/README.md b/superset-websocket/README.md index 79cbe813972..10dbcfd20f5 100644 --- a/superset-websocket/README.md +++ b/superset-websocket/README.md @@ -97,7 +97,7 @@ GLOBAL_ASYNC_QUERIES_JWT_COOKIE_NAME GLOBAL_ASYNC_QUERIES_JWT_SECRET ``` -More info on Superset configuration values for async queries: https://github.com/apache/superset/blob/master/CONTRIBUTING.md#async-chart-queries +More info on Superset configuration values for async queries: https://superset.apache.org/docs/contributing/misc#async-chart-queries ## StatsD monitoring diff --git a/superset-websocket/package-lock.json b/superset-websocket/package-lock.json index 114e39f4311..723aa0c4ee8 100644 --- a/superset-websocket/package-lock.json +++ b/superset-websocket/package-lock.json @@ -10,10 +10,10 @@ "license": "Apache-2.0", "dependencies": { "cookie": "^1.1.1", - "hot-shots": "^12.1.0", + "hot-shots": "^13.1.0", "ioredis": "^5.9.2", "jsonwebtoken": "^9.0.3", - "lodash": "^4.17.21", + "lodash": "^4.17.23", "uuid": "^11.1.0", "winston": "^3.19.0", "ws": "^8.19.0" @@ -25,25 +25,25 @@ "@types/jest": "^29.5.14", "@types/jsonwebtoken": "^9.0.10", "@types/lodash": "^4.17.23", - "@types/node": "^25.0.9", + "@types/node": "^25.0.10", "@types/uuid": "^10.0.0", "@types/ws": "^8.18.1", - "@typescript-eslint/eslint-plugin": "^8.26.0", - "@typescript-eslint/parser": "^8.51.0", + "@typescript-eslint/eslint-plugin": "^8.54.0", + "@typescript-eslint/parser": "^8.54.0", "eslint": "^9.39.2", "eslint-config-prettier": "^10.1.8", "eslint-plugin-lodash": "^8.0.0", - "globals": "^17.0.0", + "globals": "^17.1.0", "jest": "^29.7.0", - "prettier": "^3.8.0", + "prettier": "^3.8.1", "ts-jest": "^29.4.6", "ts-node": "^10.9.2", "tscw-config": "^1.1.2", "typescript": "^5.9.3", - "typescript-eslint": "^8.53.0" + "typescript-eslint": "^8.54.0" }, "engines": { - "node": "^20.19.4", + "node": "^22.22.0", "npm": "^10.8.2" } }, @@ -1823,9 +1823,9 @@ "license": "MIT" }, "node_modules/@types/node": { - "version": "25.0.9", - "resolved": "https://registry.npmjs.org/@types/node/-/node-25.0.9.tgz", - "integrity": "sha512-/rpCXHlCWeqClNBwUhDcusJxXYDjZTyE8v5oTO7WbL8eij2nKhUeU89/6xgjU7N4/Vh3He0BtyhJdQbDyhiXAw==", + "version": "25.0.10", + "resolved": "https://registry.npmjs.org/@types/node/-/node-25.0.10.tgz", + "integrity": "sha512-zWW5KPngR/yvakJgGOmZ5vTBemDoSqF3AcV/LrO5u5wTWyEAVVh+IT39G4gtyAkh3CtTZs8aX/yRM82OfzHJRg==", "dev": true, "license": "MIT", "dependencies": { @@ -1875,17 +1875,17 @@ "dev": true }, "node_modules/@typescript-eslint/eslint-plugin": { - "version": "8.53.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.53.0.tgz", - "integrity": "sha512-eEXsVvLPu8Z4PkFibtuFJLJOTAV/nPdgtSjkGoPpddpFk3/ym2oy97jynY6ic2m6+nc5M8SE1e9v/mHKsulcJg==", + "version": "8.54.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.54.0.tgz", + "integrity": "sha512-hAAP5io/7csFStuOmR782YmTthKBJ9ND3WVL60hcOjvtGFb+HJxH4O5huAcmcZ9v9G8P+JETiZ/G1B8MALnWZQ==", "dev": true, "license": "MIT", "dependencies": { "@eslint-community/regexpp": "^4.12.2", - "@typescript-eslint/scope-manager": "8.53.0", - "@typescript-eslint/type-utils": "8.53.0", - "@typescript-eslint/utils": "8.53.0", - "@typescript-eslint/visitor-keys": "8.53.0", + "@typescript-eslint/scope-manager": "8.54.0", + "@typescript-eslint/type-utils": "8.54.0", + "@typescript-eslint/utils": "8.54.0", + "@typescript-eslint/visitor-keys": "8.54.0", "ignore": "^7.0.5", "natural-compare": "^1.4.0", "ts-api-utils": "^2.4.0" @@ -1898,7 +1898,7 @@ "url": "https://opencollective.com/typescript-eslint" }, "peerDependencies": { - "@typescript-eslint/parser": "^8.53.0", + "@typescript-eslint/parser": "^8.54.0", "eslint": "^8.57.0 || ^9.0.0", "typescript": ">=4.8.4 <6.0.0" } @@ -1914,16 +1914,16 @@ } }, "node_modules/@typescript-eslint/parser": { - "version": "8.53.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.53.0.tgz", - "integrity": "sha512-npiaib8XzbjtzS2N4HlqPvlpxpmZ14FjSJrteZpPxGUaYPlvhzlzUZ4mZyABo0EFrOWnvyd0Xxroq//hKhtAWg==", + "version": "8.54.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.54.0.tgz", + "integrity": "sha512-BtE0k6cjwjLZoZixN0t5AKP0kSzlGu7FctRXYuPAm//aaiZhmfq1JwdYpYr1brzEspYyFeF+8XF5j2VK6oalrA==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/scope-manager": "8.53.0", - "@typescript-eslint/types": "8.53.0", - "@typescript-eslint/typescript-estree": "8.53.0", - "@typescript-eslint/visitor-keys": "8.53.0", + "@typescript-eslint/scope-manager": "8.54.0", + "@typescript-eslint/types": "8.54.0", + "@typescript-eslint/typescript-estree": "8.54.0", + "@typescript-eslint/visitor-keys": "8.54.0", "debug": "^4.4.3" }, "engines": { @@ -1939,14 +1939,14 @@ } }, "node_modules/@typescript-eslint/project-service": { - "version": "8.53.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.53.0.tgz", - "integrity": "sha512-Bl6Gdr7NqkqIP5yP9z1JU///Nmes4Eose6L1HwpuVHwScgDPPuEWbUVhvlZmb8hy0vX9syLk5EGNL700WcBlbg==", + "version": "8.54.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.54.0.tgz", + "integrity": "sha512-YPf+rvJ1s7MyiWM4uTRhE4DvBXrEV+d8oC3P9Y2eT7S+HBS0clybdMIPnhiATi9vZOYDc7OQ1L/i6ga6NFYK/g==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/tsconfig-utils": "^8.53.0", - "@typescript-eslint/types": "^8.53.0", + "@typescript-eslint/tsconfig-utils": "^8.54.0", + "@typescript-eslint/types": "^8.54.0", "debug": "^4.4.3" }, "engines": { @@ -1961,14 +1961,14 @@ } }, "node_modules/@typescript-eslint/scope-manager": { - "version": "8.53.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.53.0.tgz", - "integrity": "sha512-kWNj3l01eOGSdVBnfAF2K1BTh06WS0Yet6JUgb9Cmkqaz3Jlu0fdVUjj9UI8gPidBWSMqDIglmEXifSgDT/D0g==", + "version": "8.54.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.54.0.tgz", + "integrity": "sha512-27rYVQku26j/PbHYcVfRPonmOlVI6gihHtXFbTdB5sb6qA0wdAQAbyXFVarQ5t4HRojIz64IV90YtsjQSSGlQg==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/types": "8.53.0", - "@typescript-eslint/visitor-keys": "8.53.0" + "@typescript-eslint/types": "8.54.0", + "@typescript-eslint/visitor-keys": "8.54.0" }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" @@ -1979,9 +1979,9 @@ } }, "node_modules/@typescript-eslint/tsconfig-utils": { - "version": "8.53.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.53.0.tgz", - "integrity": "sha512-K6Sc0R5GIG6dNoPdOooQ+KtvT5KCKAvTcY8h2rIuul19vxH5OTQk7ArKkd4yTzkw66WnNY0kPPzzcmWA+XRmiA==", + "version": "8.54.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.54.0.tgz", + "integrity": "sha512-dRgOyT2hPk/JwxNMZDsIXDgyl9axdJI3ogZ2XWhBPsnZUv+hPesa5iuhdYt2gzwA9t8RE5ytOJ6xB0moV0Ujvw==", "dev": true, "license": "MIT", "engines": { @@ -1996,15 +1996,15 @@ } }, "node_modules/@typescript-eslint/type-utils": { - "version": "8.53.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.53.0.tgz", - "integrity": "sha512-BBAUhlx7g4SmcLhn8cnbxoxtmS7hcq39xKCgiutL3oNx1TaIp+cny51s8ewnKMpVUKQUGb41RAUWZ9kxYdovuw==", + "version": "8.54.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.54.0.tgz", + "integrity": "sha512-hiLguxJWHjjwL6xMBwD903ciAwd7DmK30Y9Axs/etOkftC3ZNN9K44IuRD/EB08amu+Zw6W37x9RecLkOo3pMA==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/types": "8.53.0", - "@typescript-eslint/typescript-estree": "8.53.0", - "@typescript-eslint/utils": "8.53.0", + "@typescript-eslint/types": "8.54.0", + "@typescript-eslint/typescript-estree": "8.54.0", + "@typescript-eslint/utils": "8.54.0", "debug": "^4.4.3", "ts-api-utils": "^2.4.0" }, @@ -2021,9 +2021,9 @@ } }, "node_modules/@typescript-eslint/types": { - "version": "8.53.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.53.0.tgz", - "integrity": "sha512-Bmh9KX31Vlxa13+PqPvt4RzKRN1XORYSLlAE+sO1i28NkisGbTtSLFVB3l7PWdHtR3E0mVMuC7JilWJ99m2HxQ==", + "version": "8.54.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.54.0.tgz", + "integrity": "sha512-PDUI9R1BVjqu7AUDsRBbKMtwmjWcn4J3le+5LpcFgWULN3LvHC5rkc9gCVxbrsrGmO1jfPybN5s6h4Jy+OnkAA==", "dev": true, "license": "MIT", "engines": { @@ -2035,16 +2035,16 @@ } }, "node_modules/@typescript-eslint/typescript-estree": { - "version": "8.53.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.53.0.tgz", - "integrity": "sha512-pw0c0Gdo7Z4xOG987u3nJ8akL9093yEEKv8QTJ+Bhkghj1xyj8cgPaavlr9rq8h7+s6plUJ4QJYw2gCZodqmGw==", + "version": "8.54.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.54.0.tgz", + "integrity": "sha512-BUwcskRaPvTk6fzVWgDPdUndLjB87KYDrN5EYGetnktoeAvPtO4ONHlAZDnj5VFnUANg0Sjm7j4usBlnoVMHwA==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/project-service": "8.53.0", - "@typescript-eslint/tsconfig-utils": "8.53.0", - "@typescript-eslint/types": "8.53.0", - "@typescript-eslint/visitor-keys": "8.53.0", + "@typescript-eslint/project-service": "8.54.0", + "@typescript-eslint/tsconfig-utils": "8.54.0", + "@typescript-eslint/types": "8.54.0", + "@typescript-eslint/visitor-keys": "8.54.0", "debug": "^4.4.3", "minimatch": "^9.0.5", "semver": "^7.7.3", @@ -2089,16 +2089,16 @@ } }, "node_modules/@typescript-eslint/utils": { - "version": "8.53.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.53.0.tgz", - "integrity": "sha512-XDY4mXTez3Z1iRDI5mbRhH4DFSt46oaIFsLg+Zn97+sYrXACziXSQcSelMybnVZ5pa1P6xYkPr5cMJyunM1ZDA==", + "version": "8.54.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.54.0.tgz", + "integrity": "sha512-9Cnda8GS57AQakvRyG0PTejJNlA2xhvyNtEVIMlDWOOeEyBkYWhGPnfrIAnqxLMTSTo6q8g12XVjjev5l1NvMA==", "dev": true, "license": "MIT", "dependencies": { "@eslint-community/eslint-utils": "^4.9.1", - "@typescript-eslint/scope-manager": "8.53.0", - "@typescript-eslint/types": "8.53.0", - "@typescript-eslint/typescript-estree": "8.53.0" + "@typescript-eslint/scope-manager": "8.54.0", + "@typescript-eslint/types": "8.54.0", + "@typescript-eslint/typescript-estree": "8.54.0" }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" @@ -2113,13 +2113,13 @@ } }, "node_modules/@typescript-eslint/visitor-keys": { - "version": "8.53.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.53.0.tgz", - "integrity": "sha512-LZ2NqIHFhvFwxG0qZeLL9DvdNAHPGCY5dIRwBhyYeU+LfLhcStE1ImjsuTG/WaVh3XysGaeLW8Rqq7cGkPCFvw==", + "version": "8.54.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.54.0.tgz", + "integrity": "sha512-VFlhGSl4opC0bprJiItPQ1RfUhGDIBokcPwaFH4yiBCaNPeld/9VeXbiPO1cLyorQi1G1vL+ecBk1x8o1axORA==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/types": "8.53.0", + "@typescript-eslint/types": "8.54.0", "eslint-visitor-keys": "^4.2.1" }, "engines": { @@ -3377,9 +3377,9 @@ } }, "node_modules/globals": { - "version": "17.0.0", - "resolved": "https://registry.npmjs.org/globals/-/globals-17.0.0.tgz", - "integrity": "sha512-gv5BeD2EssA793rlFWVPMMCqefTlpusw6/2TbAVMy0FzcG8wKJn4O+NqJ4+XWmmwrayJgw5TzrmWjFgmz1XPqw==", + "version": "17.1.0", + "resolved": "https://registry.npmjs.org/globals/-/globals-17.1.0.tgz", + "integrity": "sha512-8HoIcWI5fCvG5NADj4bDav+er9B9JMj2vyL2pI8D0eismKyUvPLTSs+Ln3wqhwcp306i73iyVnEKx3F6T47TGw==", "dev": true, "license": "MIT", "engines": { @@ -3439,9 +3439,9 @@ } }, "node_modules/hot-shots": { - "version": "12.1.0", - "resolved": "https://registry.npmjs.org/hot-shots/-/hot-shots-12.1.0.tgz", - "integrity": "sha512-Wu5rNjuBZy826Umns60bB47gF8b4rPIa0QDMXNKNMmQUqIWVlizmTgomHUS64zLChVytbieO7KDnT2M4E3/njw==", + "version": "13.1.0", + "resolved": "https://registry.npmjs.org/hot-shots/-/hot-shots-13.1.0.tgz", + "integrity": "sha512-dvLYrOSh4dZknxpsVM3nSiXZfipGDLIPtS7Ad2KSaM/oUFOIOeKg0T1Rp0KwVGP9u2e3eW4wvjbta2bNwkHU/g==", "license": "MIT", "engines": { "node": ">=16.0.0" @@ -5113,9 +5113,10 @@ } }, "node_modules/lodash": { - "version": "4.17.21", - "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz", - "integrity": "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==" + "version": "4.17.23", + "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.23.tgz", + "integrity": "sha512-LgVTMpQtIopCi79SJeDiP0TfWi5CNEc/L/aRdTh3yIvmZXTnheWpKjSZhnvMl8iXbC1tFg9gdHHDMLoV7CnG+w==", + "license": "MIT" }, "node_modules/lodash.defaults": { "version": "4.2.0", @@ -5512,9 +5513,9 @@ } }, "node_modules/prettier": { - "version": "3.8.0", - "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.8.0.tgz", - "integrity": "sha512-yEPsovQfpxYfgWNhCfECjG5AQaO+K3dp6XERmOepyPDVqcJm+bjyCVO3pmU+nAPe0N5dDvekfGezt/EIiRe1TA==", + "version": "3.8.1", + "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.8.1.tgz", + "integrity": "sha512-UOnG6LftzbdaHZcKoPFtOcCKztrQ57WkHDeRD9t/PTQtmT0NHSeWWepj6pS0z/N7+08BHFDQVUrfmfMRcZwbMg==", "dev": true, "license": "MIT", "bin": { @@ -6218,16 +6219,16 @@ } }, "node_modules/typescript-eslint": { - "version": "8.53.0", - "resolved": "https://registry.npmjs.org/typescript-eslint/-/typescript-eslint-8.53.0.tgz", - "integrity": "sha512-xHURCQNxZ1dsWn0sdOaOfCSQG0HKeqSj9OexIxrz6ypU6wHYOdX2I3D2b8s8wFSsSOYJb+6q283cLiLlkEsBYw==", + "version": "8.54.0", + "resolved": "https://registry.npmjs.org/typescript-eslint/-/typescript-eslint-8.54.0.tgz", + "integrity": "sha512-CKsJ+g53QpsNPqbzUsfKVgd3Lny4yKZ1pP4qN3jdMOg/sisIDLGyDMezycquXLE5JsEU0wp3dGNdzig0/fmSVQ==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/eslint-plugin": "8.53.0", - "@typescript-eslint/parser": "8.53.0", - "@typescript-eslint/typescript-estree": "8.53.0", - "@typescript-eslint/utils": "8.53.0" + "@typescript-eslint/eslint-plugin": "8.54.0", + "@typescript-eslint/parser": "8.54.0", + "@typescript-eslint/typescript-estree": "8.54.0", + "@typescript-eslint/utils": "8.54.0" }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" @@ -7943,9 +7944,9 @@ "dev": true }, "@types/node": { - "version": "25.0.9", - "resolved": "https://registry.npmjs.org/@types/node/-/node-25.0.9.tgz", - "integrity": "sha512-/rpCXHlCWeqClNBwUhDcusJxXYDjZTyE8v5oTO7WbL8eij2nKhUeU89/6xgjU7N4/Vh3He0BtyhJdQbDyhiXAw==", + "version": "25.0.10", + "resolved": "https://registry.npmjs.org/@types/node/-/node-25.0.10.tgz", + "integrity": "sha512-zWW5KPngR/yvakJgGOmZ5vTBemDoSqF3AcV/LrO5u5wTWyEAVVh+IT39G4gtyAkh3CtTZs8aX/yRM82OfzHJRg==", "dev": true, "requires": { "undici-types": "~7.16.0" @@ -7993,16 +7994,16 @@ "dev": true }, "@typescript-eslint/eslint-plugin": { - "version": "8.53.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.53.0.tgz", - "integrity": "sha512-eEXsVvLPu8Z4PkFibtuFJLJOTAV/nPdgtSjkGoPpddpFk3/ym2oy97jynY6ic2m6+nc5M8SE1e9v/mHKsulcJg==", + "version": "8.54.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.54.0.tgz", + "integrity": "sha512-hAAP5io/7csFStuOmR782YmTthKBJ9ND3WVL60hcOjvtGFb+HJxH4O5huAcmcZ9v9G8P+JETiZ/G1B8MALnWZQ==", "dev": true, "requires": { "@eslint-community/regexpp": "^4.12.2", - "@typescript-eslint/scope-manager": "8.53.0", - "@typescript-eslint/type-utils": "8.53.0", - "@typescript-eslint/utils": "8.53.0", - "@typescript-eslint/visitor-keys": "8.53.0", + "@typescript-eslint/scope-manager": "8.54.0", + "@typescript-eslint/type-utils": "8.54.0", + "@typescript-eslint/utils": "8.54.0", + "@typescript-eslint/visitor-keys": "8.54.0", "ignore": "^7.0.5", "natural-compare": "^1.4.0", "ts-api-utils": "^2.4.0" @@ -8017,75 +8018,75 @@ } }, "@typescript-eslint/parser": { - "version": "8.53.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.53.0.tgz", - "integrity": "sha512-npiaib8XzbjtzS2N4HlqPvlpxpmZ14FjSJrteZpPxGUaYPlvhzlzUZ4mZyABo0EFrOWnvyd0Xxroq//hKhtAWg==", + "version": "8.54.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.54.0.tgz", + "integrity": "sha512-BtE0k6cjwjLZoZixN0t5AKP0kSzlGu7FctRXYuPAm//aaiZhmfq1JwdYpYr1brzEspYyFeF+8XF5j2VK6oalrA==", "dev": true, "requires": { - "@typescript-eslint/scope-manager": "8.53.0", - "@typescript-eslint/types": "8.53.0", - "@typescript-eslint/typescript-estree": "8.53.0", - "@typescript-eslint/visitor-keys": "8.53.0", + "@typescript-eslint/scope-manager": "8.54.0", + "@typescript-eslint/types": "8.54.0", + "@typescript-eslint/typescript-estree": "8.54.0", + "@typescript-eslint/visitor-keys": "8.54.0", "debug": "^4.4.3" } }, "@typescript-eslint/project-service": { - "version": "8.53.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.53.0.tgz", - "integrity": "sha512-Bl6Gdr7NqkqIP5yP9z1JU///Nmes4Eose6L1HwpuVHwScgDPPuEWbUVhvlZmb8hy0vX9syLk5EGNL700WcBlbg==", + "version": "8.54.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.54.0.tgz", + "integrity": "sha512-YPf+rvJ1s7MyiWM4uTRhE4DvBXrEV+d8oC3P9Y2eT7S+HBS0clybdMIPnhiATi9vZOYDc7OQ1L/i6ga6NFYK/g==", "dev": true, "requires": { - "@typescript-eslint/tsconfig-utils": "^8.53.0", - "@typescript-eslint/types": "^8.53.0", + "@typescript-eslint/tsconfig-utils": "^8.54.0", + "@typescript-eslint/types": "^8.54.0", "debug": "^4.4.3" } }, "@typescript-eslint/scope-manager": { - "version": "8.53.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.53.0.tgz", - "integrity": "sha512-kWNj3l01eOGSdVBnfAF2K1BTh06WS0Yet6JUgb9Cmkqaz3Jlu0fdVUjj9UI8gPidBWSMqDIglmEXifSgDT/D0g==", + "version": "8.54.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.54.0.tgz", + "integrity": "sha512-27rYVQku26j/PbHYcVfRPonmOlVI6gihHtXFbTdB5sb6qA0wdAQAbyXFVarQ5t4HRojIz64IV90YtsjQSSGlQg==", "dev": true, "requires": { - "@typescript-eslint/types": "8.53.0", - "@typescript-eslint/visitor-keys": "8.53.0" + "@typescript-eslint/types": "8.54.0", + "@typescript-eslint/visitor-keys": "8.54.0" } }, "@typescript-eslint/tsconfig-utils": { - "version": "8.53.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.53.0.tgz", - "integrity": "sha512-K6Sc0R5GIG6dNoPdOooQ+KtvT5KCKAvTcY8h2rIuul19vxH5OTQk7ArKkd4yTzkw66WnNY0kPPzzcmWA+XRmiA==", + "version": "8.54.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.54.0.tgz", + "integrity": "sha512-dRgOyT2hPk/JwxNMZDsIXDgyl9axdJI3ogZ2XWhBPsnZUv+hPesa5iuhdYt2gzwA9t8RE5ytOJ6xB0moV0Ujvw==", "dev": true, "requires": {} }, "@typescript-eslint/type-utils": { - "version": "8.53.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.53.0.tgz", - "integrity": "sha512-BBAUhlx7g4SmcLhn8cnbxoxtmS7hcq39xKCgiutL3oNx1TaIp+cny51s8ewnKMpVUKQUGb41RAUWZ9kxYdovuw==", + "version": "8.54.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.54.0.tgz", + "integrity": "sha512-hiLguxJWHjjwL6xMBwD903ciAwd7DmK30Y9Axs/etOkftC3ZNN9K44IuRD/EB08amu+Zw6W37x9RecLkOo3pMA==", "dev": true, "requires": { - "@typescript-eslint/types": "8.53.0", - "@typescript-eslint/typescript-estree": "8.53.0", - "@typescript-eslint/utils": "8.53.0", + "@typescript-eslint/types": "8.54.0", + "@typescript-eslint/typescript-estree": "8.54.0", + "@typescript-eslint/utils": "8.54.0", "debug": "^4.4.3", "ts-api-utils": "^2.4.0" } }, "@typescript-eslint/types": { - "version": "8.53.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.53.0.tgz", - "integrity": "sha512-Bmh9KX31Vlxa13+PqPvt4RzKRN1XORYSLlAE+sO1i28NkisGbTtSLFVB3l7PWdHtR3E0mVMuC7JilWJ99m2HxQ==", + "version": "8.54.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.54.0.tgz", + "integrity": "sha512-PDUI9R1BVjqu7AUDsRBbKMtwmjWcn4J3le+5LpcFgWULN3LvHC5rkc9gCVxbrsrGmO1jfPybN5s6h4Jy+OnkAA==", "dev": true }, "@typescript-eslint/typescript-estree": { - "version": "8.53.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.53.0.tgz", - "integrity": "sha512-pw0c0Gdo7Z4xOG987u3nJ8akL9093yEEKv8QTJ+Bhkghj1xyj8cgPaavlr9rq8h7+s6plUJ4QJYw2gCZodqmGw==", + "version": "8.54.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.54.0.tgz", + "integrity": "sha512-BUwcskRaPvTk6fzVWgDPdUndLjB87KYDrN5EYGetnktoeAvPtO4ONHlAZDnj5VFnUANg0Sjm7j4usBlnoVMHwA==", "dev": true, "requires": { - "@typescript-eslint/project-service": "8.53.0", - "@typescript-eslint/tsconfig-utils": "8.53.0", - "@typescript-eslint/types": "8.53.0", - "@typescript-eslint/visitor-keys": "8.53.0", + "@typescript-eslint/project-service": "8.54.0", + "@typescript-eslint/tsconfig-utils": "8.54.0", + "@typescript-eslint/types": "8.54.0", + "@typescript-eslint/visitor-keys": "8.54.0", "debug": "^4.4.3", "minimatch": "^9.0.5", "semver": "^7.7.3", @@ -8114,24 +8115,24 @@ } }, "@typescript-eslint/utils": { - "version": "8.53.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.53.0.tgz", - "integrity": "sha512-XDY4mXTez3Z1iRDI5mbRhH4DFSt46oaIFsLg+Zn97+sYrXACziXSQcSelMybnVZ5pa1P6xYkPr5cMJyunM1ZDA==", + "version": "8.54.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.54.0.tgz", + "integrity": "sha512-9Cnda8GS57AQakvRyG0PTejJNlA2xhvyNtEVIMlDWOOeEyBkYWhGPnfrIAnqxLMTSTo6q8g12XVjjev5l1NvMA==", "dev": true, "requires": { "@eslint-community/eslint-utils": "^4.9.1", - "@typescript-eslint/scope-manager": "8.53.0", - "@typescript-eslint/types": "8.53.0", - "@typescript-eslint/typescript-estree": "8.53.0" + "@typescript-eslint/scope-manager": "8.54.0", + "@typescript-eslint/types": "8.54.0", + "@typescript-eslint/typescript-estree": "8.54.0" } }, "@typescript-eslint/visitor-keys": { - "version": "8.53.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.53.0.tgz", - "integrity": "sha512-LZ2NqIHFhvFwxG0qZeLL9DvdNAHPGCY5dIRwBhyYeU+LfLhcStE1ImjsuTG/WaVh3XysGaeLW8Rqq7cGkPCFvw==", + "version": "8.54.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.54.0.tgz", + "integrity": "sha512-VFlhGSl4opC0bprJiItPQ1RfUhGDIBokcPwaFH4yiBCaNPeld/9VeXbiPO1cLyorQi1G1vL+ecBk1x8o1axORA==", "dev": true, "requires": { - "@typescript-eslint/types": "8.53.0", + "@typescript-eslint/types": "8.54.0", "eslint-visitor-keys": "^4.2.1" }, "dependencies": { @@ -9018,9 +9019,9 @@ } }, "globals": { - "version": "17.0.0", - "resolved": "https://registry.npmjs.org/globals/-/globals-17.0.0.tgz", - "integrity": "sha512-gv5BeD2EssA793rlFWVPMMCqefTlpusw6/2TbAVMy0FzcG8wKJn4O+NqJ4+XWmmwrayJgw5TzrmWjFgmz1XPqw==", + "version": "17.1.0", + "resolved": "https://registry.npmjs.org/globals/-/globals-17.1.0.tgz", + "integrity": "sha512-8HoIcWI5fCvG5NADj4bDav+er9B9JMj2vyL2pI8D0eismKyUvPLTSs+Ln3wqhwcp306i73iyVnEKx3F6T47TGw==", "dev": true }, "graceful-fs": { @@ -9058,9 +9059,9 @@ } }, "hot-shots": { - "version": "12.1.0", - "resolved": "https://registry.npmjs.org/hot-shots/-/hot-shots-12.1.0.tgz", - "integrity": "sha512-Wu5rNjuBZy826Umns60bB47gF8b4rPIa0QDMXNKNMmQUqIWVlizmTgomHUS64zLChVytbieO7KDnT2M4E3/njw==", + "version": "13.1.0", + "resolved": "https://registry.npmjs.org/hot-shots/-/hot-shots-13.1.0.tgz", + "integrity": "sha512-dvLYrOSh4dZknxpsVM3nSiXZfipGDLIPtS7Ad2KSaM/oUFOIOeKg0T1Rp0KwVGP9u2e3eW4wvjbta2bNwkHU/g==", "requires": { "unix-dgram": "2.x" } @@ -10352,9 +10353,9 @@ } }, "lodash": { - "version": "4.17.21", - "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz", - "integrity": "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==" + "version": "4.17.23", + "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.23.tgz", + "integrity": "sha512-LgVTMpQtIopCi79SJeDiP0TfWi5CNEc/L/aRdTh3yIvmZXTnheWpKjSZhnvMl8iXbC1tFg9gdHHDMLoV7CnG+w==" }, "lodash.defaults": { "version": "4.2.0", @@ -10666,9 +10667,9 @@ "dev": true }, "prettier": { - "version": "3.8.0", - "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.8.0.tgz", - "integrity": "sha512-yEPsovQfpxYfgWNhCfECjG5AQaO+K3dp6XERmOepyPDVqcJm+bjyCVO3pmU+nAPe0N5dDvekfGezt/EIiRe1TA==", + "version": "3.8.1", + "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.8.1.tgz", + "integrity": "sha512-UOnG6LftzbdaHZcKoPFtOcCKztrQ57WkHDeRD9t/PTQtmT0NHSeWWepj6pS0z/N7+08BHFDQVUrfmfMRcZwbMg==", "dev": true }, "pretty-format": { @@ -11104,15 +11105,15 @@ "dev": true }, "typescript-eslint": { - "version": "8.53.0", - "resolved": "https://registry.npmjs.org/typescript-eslint/-/typescript-eslint-8.53.0.tgz", - "integrity": "sha512-xHURCQNxZ1dsWn0sdOaOfCSQG0HKeqSj9OexIxrz6ypU6wHYOdX2I3D2b8s8wFSsSOYJb+6q283cLiLlkEsBYw==", + "version": "8.54.0", + "resolved": "https://registry.npmjs.org/typescript-eslint/-/typescript-eslint-8.54.0.tgz", + "integrity": "sha512-CKsJ+g53QpsNPqbzUsfKVgd3Lny4yKZ1pP4qN3jdMOg/sisIDLGyDMezycquXLE5JsEU0wp3dGNdzig0/fmSVQ==", "dev": true, "requires": { - "@typescript-eslint/eslint-plugin": "8.53.0", - "@typescript-eslint/parser": "8.53.0", - "@typescript-eslint/typescript-estree": "8.53.0", - "@typescript-eslint/utils": "8.53.0" + "@typescript-eslint/eslint-plugin": "8.54.0", + "@typescript-eslint/parser": "8.54.0", + "@typescript-eslint/typescript-estree": "8.54.0", + "@typescript-eslint/utils": "8.54.0" } }, "uglify-js": { diff --git a/superset-websocket/package.json b/superset-websocket/package.json index 176f208f82b..f3c35396813 100644 --- a/superset-websocket/package.json +++ b/superset-websocket/package.json @@ -18,10 +18,10 @@ "license": "Apache-2.0", "dependencies": { "cookie": "^1.1.1", - "hot-shots": "^12.1.0", + "hot-shots": "^13.1.0", "ioredis": "^5.9.2", "jsonwebtoken": "^9.0.3", - "lodash": "^4.17.21", + "lodash": "^4.17.23", "uuid": "^11.1.0", "winston": "^3.19.0", "ws": "^8.19.0" @@ -33,25 +33,25 @@ "@types/jest": "^29.5.14", "@types/jsonwebtoken": "^9.0.10", "@types/lodash": "^4.17.23", - "@types/node": "^25.0.9", + "@types/node": "^25.0.10", "@types/uuid": "^10.0.0", "@types/ws": "^8.18.1", - "@typescript-eslint/eslint-plugin": "^8.26.0", - "@typescript-eslint/parser": "^8.51.0", + "@typescript-eslint/eslint-plugin": "^8.54.0", + "@typescript-eslint/parser": "^8.54.0", "eslint": "^9.39.2", "eslint-config-prettier": "^10.1.8", "eslint-plugin-lodash": "^8.0.0", - "globals": "^17.0.0", + "globals": "^17.1.0", "jest": "^29.7.0", - "prettier": "^3.8.0", + "prettier": "^3.8.1", "ts-jest": "^29.4.6", "ts-node": "^10.9.2", "tscw-config": "^1.1.2", "typescript": "^5.9.3", - "typescript-eslint": "^8.53.0" + "typescript-eslint": "^8.54.0" }, "engines": { - "node": "^20.19.4", + "node": "^22.22.0", "npm": "^10.8.2" } } diff --git a/superset/charts/schemas.py b/superset/charts/schemas.py index fc7af43aef5..8cc500ecac1 100644 --- a/superset/charts/schemas.py +++ b/superset/charts/schemas.py @@ -1029,6 +1029,13 @@ class ChartDataExtrasSchema(Schema): }, allow_none=True, ) + transpile_to_dialect = fields.Boolean( + metadata={ + "description": "If true, WHERE/HAVING clauses will be transpiled to the " + "target database dialect using SQLGlot." + }, + allow_none=True, + ) class AnnotationLayerSchema(Schema): diff --git a/superset/cli/examples.py b/superset/cli/examples.py index cf7c569df95..d8a7ac8ec7a 100755 --- a/superset/cli/examples.py +++ b/superset/cli/examples.py @@ -15,6 +15,7 @@ # specific language governing permissions and limitations # under the License. import logging +from typing import Any, Callable import click from flask.cli import with_appcontext @@ -25,6 +26,44 @@ from superset.utils.decorators import transaction logger = logging.getLogger(__name__) +def _should_skip_loader( + loader_name: str, load_big_data: bool, only_metadata: bool +) -> bool: + """Check if a loader should be skipped.""" + # Skip special loaders that aren't datasets + if loader_name in ["load_css_templates", "load_examples_from_configs"]: + return True + + # Skip big data if not requested or when only metadata is requested + if loader_name == "load_big_data" and (not load_big_data or only_metadata): + return True + + return False + + +def _load_dataset( + loader: Callable[..., Any], loader_name: str, only_metadata: bool, force: bool +) -> None: + """Load a single dataset with error handling.""" + import inspect + + dataset_name = loader_name[5:].replace("_", " ").title() + logger.info("Loading [%s]", dataset_name) + + # Call loader with appropriate parameters + sig = inspect.signature(loader) + params = {} + if "only_metadata" in sig.parameters: + params["only_metadata"] = only_metadata + if "force" in sig.parameters: + params["force"] = force + + try: + loader(**params) + except Exception as e: + logger.warning("Failed to load %s: %s", dataset_name, e) + + def load_examples_run( load_test_data: bool = False, load_big_data: bool = False, @@ -40,54 +79,21 @@ def load_examples_run( # pylint: disable=import-outside-toplevel import superset.examples.data_loading as examples + # Always load CSS templates examples.load_css_templates() - if load_test_data: - logger.info("Loading energy related dataset") - examples.load_energy(only_metadata, force) + # Auto-discover and load all datasets + for loader_name in dir(examples): + if not loader_name.startswith("load_"): + continue - logger.info("Loading [World Bank's Health Nutrition and Population Stats]") - examples.load_world_bank_health_n_pop(only_metadata, force) + if _should_skip_loader(loader_name, load_big_data, only_metadata): + continue - logger.info("Loading [Birth names]") - examples.load_birth_names(only_metadata, force) + loader = getattr(examples, loader_name) + _load_dataset(loader, loader_name, only_metadata, force) - logger.info("Loading [International Sales]") - examples.load_international_sales(only_metadata, force) - - if load_test_data: - logger.info("Loading [Tabbed dashboard]") - examples.load_tabbed_dashboard(only_metadata) - - logger.info("Loading [Supported Charts Dashboard]") - examples.load_supported_charts_dashboard() - else: - logger.info("Loading [Random long/lat data]") - examples.load_long_lat_data(only_metadata, force) - - logger.info("Loading [Country Map data]") - examples.load_country_map_data(only_metadata, force) - - logger.info("Loading [San Francisco population polygons]") - examples.load_sf_population_polygons(only_metadata, force) - - logger.info("Loading [Flights data]") - examples.load_flights(only_metadata, force) - - logger.info("Loading [BART lines]") - examples.load_bart_lines(only_metadata, force) - - logger.info("Loading [Misc Charts] dashboard") - examples.load_misc_dashboard() - - logger.info("Loading DECK.gl demo") - examples.load_deck_dash() - - if load_big_data: - logger.info("Loading big synthetic data for tests") - examples.load_big_data() - - # load examples that are stored as YAML config files + # Load examples that are stored as YAML config files examples.load_examples_from_configs(force, load_test_data) diff --git a/superset/cli/export_example.py b/superset/cli/export_example.py new file mode 100644 index 00000000000..5c14b62dab3 --- /dev/null +++ b/superset/cli/export_example.py @@ -0,0 +1,234 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +"""CLI command to export a dashboard as an example. + +This creates an example-ready folder structure that can be committed +to superset/examples/ and loaded via the example loading system. + +Usage: + superset export-example --dashboard-id 123 --name my_example + superset export-example --dashboard-slug my-dashboard --name my_example +""" + +from __future__ import annotations + +import logging +from pathlib import Path +from typing import Optional + +import click +from flask.cli import with_appcontext + +logger = logging.getLogger(__name__) + +APACHE_LICENSE_HEADER = """# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +""" + + +def write_file_with_header(path: Path, content: bytes) -> None: + """Write file, adding Apache license header for YAML files.""" + path.parent.mkdir(parents=True, exist_ok=True) + + if path.suffix == ".yaml": + # Add license header to YAML files + with open(path, "wb") as f: + f.write(APACHE_LICENSE_HEADER.encode("utf-8")) + f.write(content) + else: + # Binary files (like Parquet) written as-is + with open(path, "wb") as f: + f.write(content) + + logger.info("Wrote %s", path) + + +@click.command() +@with_appcontext +@click.option("--dashboard-id", "-d", type=int, help="Dashboard ID to export") +@click.option("--dashboard-slug", "-s", type=str, help="Dashboard slug to export") +@click.option("--name", "-n", required=True, help="Name for the example folder") +@click.option( + "--output-dir", + "-o", + default="superset/examples", + help="Output directory (default: superset/examples)", +) +@click.option( + "--export-data/--no-export-data", + default=True, + help="Export data to Parquet (default: True)", +) +@click.option( + "--sample-rows", type=int, default=None, help="Limit data export to this many rows" +) +@click.option("--force", "-f", is_flag=True, help="Overwrite existing example folder") +def export_example( # noqa: C901 + dashboard_id: Optional[int], + dashboard_slug: Optional[str], + name: str, + output_dir: str, + export_data: bool, + sample_rows: Optional[int], + force: bool, +) -> None: + """Export a dashboard as an example. + + Creates a folder structure in superset/examples/ that can be loaded + by the example loading system: + + \b + Single dataset: + / + ├── data.parquet # Raw data + ├── dataset.yaml # Dataset metadata + ├── dashboard.yaml # Dashboard definition + └── charts/ + └── *.yaml # Chart definitions + + \b + Multiple datasets: + / + ├── data/ + │ ├── table1.parquet + │ └── table2.parquet + ├── datasets/ + │ ├── table1.yaml + │ └── table2.yaml + ├── dashboard.yaml + └── charts/ + └── *.yaml + + Examples: + + \b + # Export by dashboard ID + superset export-example -d 1 -n my_example + + \b + # Export by slug, limit data to 1000 rows + superset export-example -s my-dashboard -n my_example --sample-rows 1000 + + \b + # Export metadata only (no data) + superset export-example -d 1 -n my_example --no-export-data + """ + # Import at runtime to avoid app initialization issues during CLI loading + # pylint: disable=import-outside-toplevel + from flask import g + + from superset import db, security_manager + from superset.commands.dashboard.exceptions import DashboardNotFoundError + from superset.commands.dashboard.export_example import ExportExampleCommand + from superset.models.dashboard import Dashboard + from superset.utils import json as superset_json + + g.user = security_manager.find_user(username="admin") + + # Find the dashboard + if dashboard_id: + dashboard = db.session.query(Dashboard).get(dashboard_id) + elif dashboard_slug: + dashboard = db.session.query(Dashboard).filter_by(slug=dashboard_slug).first() + else: + raise click.UsageError("Must specify --dashboard-id or --dashboard-slug") + + if not dashboard: + raise click.ClickException( + f"Dashboard not found: {dashboard_id or dashboard_slug}" + ) + + logger.info("Exporting dashboard: %s", dashboard.dashboard_title) + + # Create output directory + example_dir = Path(output_dir) / name + if example_dir.exists() and not force: + raise click.ClickException( + f"Directory already exists: {example_dir}. Use --force to overwrite." + ) + + example_dir.mkdir(parents=True, exist_ok=True) + + # Run the export command + command = ExportExampleCommand( + dashboard_id=dashboard.id, + export_data=export_data, + sample_rows=sample_rows, + ) + + try: + file_count = {"charts": 0, "datasets": 0, "data": 0} + + for filename, content_fn in command.run(): + file_path = example_dir / filename + content = content_fn() + write_file_with_header(file_path, content) + + # Track file counts for summary + if filename.startswith("charts/"): + file_count["charts"] += 1 + elif filename.startswith("datasets/") or filename == "dataset.yaml": + file_count["datasets"] += 1 + elif filename.startswith("data/") or filename == "data.parquet": + file_count["data"] += 1 + + except DashboardNotFoundError as err: + raise click.ClickException( + f"Dashboard not found: {dashboard_id or dashboard_slug}" + ) from err + + # Summary + click.echo(f"\n✅ Exported to: {example_dir}") + click.echo(" - dashboard.yaml") + + if file_count["datasets"] > 1: + click.echo(f" - datasets/ ({file_count['datasets']} datasets)") + if export_data and file_count["data"]: + click.echo(f" - data/ ({file_count['data']} parquet files)") + else: + click.echo(" - dataset.yaml") + if export_data and file_count["data"]: + click.echo(" - data.parquet") + + click.echo(f" - charts/ ({file_count['charts']} charts)") + + # Native filters summary + if dashboard.json_metadata: + try: + meta = superset_json.loads(dashboard.json_metadata) + filters = meta.get("native_filter_configuration", []) + if filters: + click.echo(f" - {len(filters)} native filters exported") + except Exception: + logger.debug("Could not parse json_metadata for filter count") + + click.echo("\nTo load this example, ensure the folder is in superset/examples/") + click.echo("and it will be picked up by load_examples_from_configs().") diff --git a/superset/examples/big_data.py b/superset/cli/test_loaders.py similarity index 87% rename from superset/examples/big_data.py rename to superset/cli/test_loaders.py index 738cae3d570..79a756788e0 100644 --- a/superset/examples/big_data.py +++ b/superset/cli/test_loaders.py @@ -14,6 +14,18 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. +"""Test data loaders for stress testing and development. + +This module contains specialized data loaders that generate synthetic data +for testing Superset's capabilities with edge cases: +- Wide tables (many columns) +- Many tables (testing catalog performance) +- Long table names (UI edge cases) + +These loaders are invoked via CLI flags and are not part of the standard +example datasets. +""" + import logging import random import string diff --git a/superset/commands/dashboard/export_example.py b/superset/commands/dashboard/export_example.py new file mode 100644 index 00000000000..7924fe0ad4d --- /dev/null +++ b/superset/commands/dashboard/export_example.py @@ -0,0 +1,672 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +"""Command to export a dashboard as an example bundle. + +This creates an example-ready structure that can be committed to +superset/examples/ and loaded via the example loading system. +""" + +from __future__ import annotations + +import logging +from collections.abc import Iterator +from io import BytesIO +from typing import Any, Callable, TYPE_CHECKING + +import yaml + +from superset.commands.base import BaseCommand +from superset.commands.dashboard.exceptions import DashboardNotFoundError +from superset.daos.dashboard import DashboardDAO + +if TYPE_CHECKING: + from superset.connectors.sqla.models import SqlaTable + from superset.models.dashboard import Dashboard + from superset.models.slice import Slice + +from superset.sql.parse import SQLStatement, Table + +logger = logging.getLogger(__name__) + +# Canonical UUID for the examples database +EXAMPLES_DATABASE_UUID = "a2dc77af-e654-49bb-b321-40f6b559a1ee" + +# ASF license header for generated YAML files +YAML_LICENSE_HEADER = """\ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +""" + + +def sanitize_filename(name: str) -> str: + """Convert a name to a safe filename.""" + safe = "".join(c if c.isalnum() or c in "._-" else "_" for c in name) + while "__" in safe: + safe = safe.replace("__", "_") + return safe.strip("_") + + +def get_referenced_tables(sql: str, engine: str = "base") -> set[Table]: + """Extract table references from SQL using Superset's SQL parser. + + Args: + sql: The SQL query to parse + engine: The database engine/dialect (e.g., "postgresql", "mysql") + + Returns: + Set of Table objects referenced in the SQL + """ + try: + statement = SQLStatement(sql, engine=engine) + return statement.tables + except Exception as e: + logger.warning("Could not parse SQL to extract tables: %s", e) + return set() + + +def is_virtual_dataset(dataset: SqlaTable) -> bool: + """Check if a dataset is virtual (SQL-based) vs physical (table-based).""" + return bool(dataset.sql) + + +def can_preserve_virtual_dataset( + dataset: SqlaTable, + physical_tables: set[str], + engine: str = "base", +) -> bool: + """Check if a virtual dataset can be preserved (all dependencies are in export). + + A virtual dataset can be preserved if all tables it references are + physical tables that will be exported as Parquet files. + + Args: + dataset: The virtual dataset to check + physical_tables: Set of physical table names being exported + engine: The database engine/dialect for SQL parsing + + Returns: + True if the virtual dataset can be preserved with its SQL intact + """ + if not dataset.sql: + return False # Not a virtual dataset + + referenced = get_referenced_tables(dataset.sql, engine) + if not referenced: + # Couldn't parse SQL or no tables found - safer to materialize + logger.info( + "Could not determine dependencies for %s, will materialize", + dataset.table_name, + ) + return False + + # Check if all referenced tables are in our physical tables set + for table in referenced: + # Match by table name (ignore schema since we normalize to default schema) + if table.table not in physical_tables: + logger.info( + "Virtual dataset %s references external table %s, will materialize", + dataset.table_name, + table.table, + ) + return False + + logger.info( + "Virtual dataset %s can be preserved (references: %s)", + dataset.table_name, + ", ".join(t.table for t in referenced), + ) + return True + + +def export_dataset_yaml( + dataset: SqlaTable, + data_file: str | None = None, + preserve_virtual: bool = False, +) -> dict[str, Any]: + """Export a dataset to YAML format. + + Args: + dataset: The dataset to export + data_file: Optional explicit parquet filename (for physical datasets) + preserve_virtual: If True and dataset is virtual, preserve the SQL query + instead of converting to physical with data_file + """ + # Determine if this is a preserved virtual dataset + is_preserved_virtual = preserve_virtual and dataset.sql + + dataset_config: dict[str, Any] = { + "table_name": dataset.table_name, + # Virtual datasets don't have data files - they query other tables + "data_file": None if is_preserved_virtual else data_file, + "main_dttm_col": dataset.main_dttm_col, + "description": dataset.description, + "default_endpoint": dataset.default_endpoint, + "offset": dataset.offset, + "cache_timeout": dataset.cache_timeout, + "catalog": dataset.catalog, + "schema": None, # Don't export - use target database's default schema + # Preserve SQL for virtual datasets, None for physical (data is in parquet) + "sql": dataset.sql if is_preserved_virtual else None, + # Track source database engine for SQL transpilation during import + "source_db_engine": ( + dataset.database.db_engine_spec.engine if is_preserved_virtual else None + ), + "params": None, # Don't export - contains stale import metadata + "template_params": dataset.template_params, + "filter_select_enabled": dataset.filter_select_enabled, + "fetch_values_predicate": dataset.fetch_values_predicate, + "extra": dataset.extra, + "normalize_columns": dataset.normalize_columns, + "always_filter_main_dttm": dataset.always_filter_main_dttm, + "folders": None, + "uuid": str(dataset.uuid), + "metrics": [], + "columns": [], + "version": "1.0.0", + "database_uuid": EXAMPLES_DATABASE_UUID, + } + + for metric in dataset.metrics: + dataset_config["metrics"].append( + { + "metric_name": metric.metric_name, + "verbose_name": metric.verbose_name, + "metric_type": metric.metric_type, + "expression": metric.expression, + "description": metric.description, + "d3format": metric.d3format, + "currency": metric.currency, + "extra": metric.extra, + "warning_text": metric.warning_text, + } + ) + + for column in dataset.columns: + dataset_config["columns"].append( + { + "column_name": column.column_name, + "verbose_name": column.verbose_name, + "is_dttm": column.is_dttm, + "is_active": column.is_active, + "type": column.type, + "advanced_data_type": column.advanced_data_type, + "groupby": column.groupby, + "filterable": column.filterable, + "expression": column.expression, + "description": column.description, + "python_date_format": column.python_date_format, + "extra": column.extra, + } + ) + + return dataset_config + + +def export_dataset_data( + dataset: SqlaTable, + sample_rows: int | None = None, +) -> bytes | None: + """Export dataset data to Parquet format. Returns bytes or None on failure.""" + import pandas as pd # pylint: disable=import-outside-toplevel + + from superset import db # pylint: disable=import-outside-toplevel + + # Ensure dataset is attached to session and relationships are loaded + if dataset not in db.session: + dataset = db.session.merge(dataset) + + # Force load the database and columns relationships by accessing them + _ = dataset.database + _ = dataset.columns + + if not dataset.database: + logger.warning("Dataset %s has no database", dataset.table_name) + return None + + try: + logger.info("Exporting data for %s to Parquet...", dataset.table_name) + + # Check if this is a virtual dataset (SQL-based) + if dataset.sql: + sql = dataset.sql + else: + # For physical tables, build SELECT query from columns + columns = [col.column_name for col in dataset.columns if not col.expression] + + if not columns: + logger.warning("No columns to export for %s", dataset.table_name) + return None + + # Build simple SELECT query (quote identifiers to handle spaces/keywords) + column_list = ", ".join(f'"{c}"' for c in columns) + quoted_table = f'"{dataset.table_name}"' + if dataset.schema: + table_ref = f'"{dataset.schema}".{quoted_table}' + else: + table_ref = quoted_table + sql = f"SELECT {column_list} FROM {table_ref}" # noqa: S608 + + with dataset.database.get_sqla_engine() as engine: + df = pd.read_sql(sql, engine) + + if sample_rows and len(df) > sample_rows: + df = df.head(sample_rows) + logger.info("Sampled to %d rows", sample_rows) + + # Write to bytes buffer + buf = BytesIO() + df.to_parquet(buf, index=False) + buf.seek(0) + logger.info("Exported %d rows for %s", len(df), dataset.table_name) + return buf.getvalue() + + except Exception as e: + logger.exception("Could not export data for %s: %s", dataset.table_name, e) + return None + + +def export_chart(chart: Slice, dataset_uuid: str) -> dict[str, Any]: + """Export a chart to YAML format.""" + params = chart.params_dict if hasattr(chart, "params_dict") else {} + + return { + "slice_name": chart.slice_name, + "description": chart.description, + "certified_by": chart.certified_by, + "certification_details": chart.certification_details, + "viz_type": chart.viz_type, + "params": params, + "query_context": None, # Don't include - contains stale IDs + "cache_timeout": chart.cache_timeout, + "uuid": str(chart.uuid), + "version": "1.0.0", + "dataset_uuid": dataset_uuid, + } + + +def remap_native_filters( + filters: list[dict[str, Any]], + chart_id_to_uuid: dict[int, str], + dataset_id_to_uuid: dict[int, str], +) -> list[dict[str, Any]]: + """Remap IDs to UUIDs in native filter configuration.""" + remapped = [] + for f in filters: + new_filter = f.copy() + + # Remap chartsInScope from IDs to UUIDs + if "chartsInScope" in new_filter: + new_filter["chartsInScope"] = [ + chart_id_to_uuid.get(cid, cid) for cid in new_filter["chartsInScope"] + ] + + # Remap targets to use datasetUuid + if "targets" in new_filter: + new_targets = [] + for target in new_filter["targets"]: + new_target = target.copy() + if "datasetId" in new_target: + dataset_id = new_target.pop("datasetId") + if dataset_id in dataset_id_to_uuid: + new_target["datasetUuid"] = dataset_id_to_uuid[dataset_id] + new_targets.append(new_target) + new_filter["targets"] = new_targets + + remapped.append(new_filter) + return remapped + + +def remap_chart_configuration( + chart_config: dict[str, Any], + chart_id_to_uuid: dict[int, str], +) -> dict[str, Any]: + """Remap chart IDs to UUIDs in chart_configuration (cross-filters).""" + remapped: dict[str, Any] = {} + for chart_id_str, config in chart_config.items(): + chart_id = int(chart_id_str) + if chart_id not in chart_id_to_uuid: + continue + + new_config = config.copy() + chart_uuid = chart_id_to_uuid[chart_id] + + # Update the id field + new_config["id"] = chart_uuid + + # Remap chartsInScope + cross_filters = new_config.get("crossFilters", {}) + if "chartsInScope" in cross_filters: + new_config["crossFilters"] = new_config["crossFilters"].copy() + new_config["crossFilters"]["chartsInScope"] = [ + chart_id_to_uuid.get(cid, cid) + for cid in new_config["crossFilters"]["chartsInScope"] + ] + + remapped[chart_uuid] = new_config + + return remapped + + +def remap_global_chart_configuration( + global_config: dict[str, Any], + chart_id_to_uuid: dict[int, str], +) -> dict[str, Any]: + """Remap chart IDs in global_chart_configuration.""" + new_config = global_config.copy() + if "chartsInScope" in new_config: + new_config["chartsInScope"] = [ + chart_id_to_uuid.get(cid, cid) for cid in new_config["chartsInScope"] + ] + return new_config + + +def export_dashboard_yaml( + dashboard: Dashboard, + chart_id_to_uuid: dict[int, str], + dataset_id_to_uuid: dict[int, str], +) -> dict[str, Any]: + """Export dashboard to YAML format with proper ID remapping.""" + from superset.utils import ( + json as superset_json, # pylint: disable=import-outside-toplevel + ) + + position = dashboard.position or {} + + # Update position to use UUIDs + updated_position = {} + for key, value in position.items(): + if isinstance(value, dict): + updated_value = value.copy() + if "meta" in updated_value and "chartId" in updated_value.get("meta", {}): + chart_id = updated_value["meta"]["chartId"] + if chart_id in chart_id_to_uuid: + updated_value["meta"]["uuid"] = chart_id_to_uuid[chart_id] + updated_position[key] = updated_value + else: + updated_position[key] = value + + # Parse json_metadata + json_metadata = {} + if dashboard.json_metadata: + try: + json_metadata = superset_json.loads(dashboard.json_metadata) + except Exception: + logger.debug("Could not parse json_metadata") + + # Remap native filters + native_filters = json_metadata.get("native_filter_configuration", []) + remapped_filters = remap_native_filters( + native_filters, chart_id_to_uuid, dataset_id_to_uuid + ) + + # Remap chart_configuration (cross-filters) + chart_configuration = json_metadata.get("chart_configuration", {}) + remapped_chart_config = remap_chart_configuration( + chart_configuration, chart_id_to_uuid + ) + + # Remap global_chart_configuration + global_chart_config = json_metadata.get("global_chart_configuration", {}) + remapped_global_config = remap_global_chart_configuration( + global_chart_config, chart_id_to_uuid + ) + + # Build metadata section + metadata: dict[str, Any] = { + "timed_refresh_immune_slices": json_metadata.get( + "timed_refresh_immune_slices", [] + ), + "expanded_slices": json_metadata.get("expanded_slices", {}), + "refresh_frequency": json_metadata.get("refresh_frequency", 0), + "default_filters": json_metadata.get("default_filters", "{}"), + "color_scheme": json_metadata.get("color_scheme", ""), + "label_colors": json_metadata.get("label_colors", {}), + "native_filter_configuration": remapped_filters, + "shared_label_colors": json_metadata.get("shared_label_colors", []), + "map_label_colors": json_metadata.get("map_label_colors", {}), + "color_scheme_domain": json_metadata.get("color_scheme_domain", []), + "cross_filters_enabled": json_metadata.get("cross_filters_enabled", False), + "chart_configuration": remapped_chart_config, + "global_chart_configuration": remapped_global_config, + } + + return { + "dashboard_title": dashboard.dashboard_title, + "description": dashboard.description, + "css": dashboard.css, + "slug": dashboard.slug, + "certified_by": dashboard.certified_by, + "certification_details": dashboard.certification_details, + "published": dashboard.published, + "uuid": str(dashboard.uuid), + "position": updated_position, + "metadata": metadata, + "version": "1.0.0", + } + + +def _make_yaml_generator(config: dict[str, Any]) -> Callable[[], bytes]: + """Create a generator function for YAML content with ASF license header.""" + yaml_content = yaml.safe_dump(config, default_flow_style=False, allow_unicode=True) + return lambda: (YAML_LICENSE_HEADER + yaml_content).encode("utf-8") + + +def _make_bytes_generator(data: bytes) -> Callable[[], bytes]: + """Create a generator function for raw bytes content.""" + return lambda: data + + +class ExportExampleCommand(BaseCommand): + """Export dashboard as an example bundle with Parquet data and YAML configs. + + Output structure for single dataset: + data.parquet - Raw data + dataset.yaml - Dataset metadata + dashboard.yaml - Dashboard definition + charts/*.yaml - Chart definitions + + Output structure for multiple datasets: + data/*.parquet - Raw data files + datasets/*.yaml - Dataset metadata files + dashboard.yaml - Dashboard definition + charts/*.yaml - Chart definitions + """ + + def __init__( + self, + dashboard_id: int, + export_data: bool = True, + sample_rows: int | None = None, + ): + self._dashboard_id = dashboard_id + self._export_data = export_data + self._sample_rows = sample_rows + self._dashboard: Dashboard | None = None + + def validate(self) -> None: + self._dashboard = DashboardDAO.find_by_id(self._dashboard_id) + if not self._dashboard: + raise DashboardNotFoundError() + + def run(self) -> Iterator[tuple[str, Callable[[], bytes]]]: # noqa: C901 + """Yield (filename, content_generator) tuples for ZIP packaging. + + Content generators return bytes (either YAML encoded or raw Parquet). + """ + self.validate() + assert self._dashboard is not None + + # Collect all charts and their datasets + charts = self._dashboard.slices + datasets: dict[int, SqlaTable] = {} + chart_id_to_uuid: dict[int, str] = {} + chart_to_dataset_uuid: dict[int, str] = {} + + for chart in charts: + chart_id_to_uuid[chart.id] = str(chart.uuid) + if chart.datasource: + datasets[chart.datasource.id] = chart.datasource + chart_to_dataset_uuid[chart.id] = str(chart.datasource.uuid) + + # Build dataset ID to UUID mapping + dataset_id_to_uuid: dict[int, str] = { + ds_id: str(ds.uuid) for ds_id, ds in datasets.items() + } + + logger.info("Found %d charts and %d datasets", len(charts), len(datasets)) + + # Classify datasets: physical vs virtual + # Physical datasets need Parquet export; virtual datasets with all + # dependencies in the export can preserve their SQL + physical_datasets: dict[int, SqlaTable] = {} + virtual_datasets: dict[int, SqlaTable] = {} + + for ds_id, dataset in datasets.items(): + if is_virtual_dataset(dataset): + virtual_datasets[ds_id] = dataset + else: + physical_datasets[ds_id] = dataset + + # Get the set of physical table names for dependency checking + physical_table_names = {ds.table_name for ds in physical_datasets.values()} + + # Determine which virtual datasets can be preserved vs need materialization + # A virtual dataset can be preserved if all its referenced tables are + # physical datasets in this export + preserved_virtual: dict[int, SqlaTable] = {} + materialized_virtual: dict[int, SqlaTable] = {} + + # Get database engine for SQL parsing (use first dataset's database) + db_engine = "base" + if datasets: + first_dataset = next(iter(datasets.values())) + if first_dataset.database: + db_engine = first_dataset.database.backend or "base" + + for ds_id, dataset in virtual_datasets.items(): + if can_preserve_virtual_dataset(dataset, physical_table_names, db_engine): + preserved_virtual[ds_id] = dataset + else: + materialized_virtual[ds_id] = dataset + + # Log classification summary + logger.info( + "Dataset classification: %d physical, %d virtual preserved, " + "%d virtual materialized", + len(physical_datasets), + len(preserved_virtual), + len(materialized_virtual), + ) + + # Datasets that need Parquet export = physical + materialized virtual + datasets_needing_data = {**physical_datasets, **materialized_virtual} + + # Build unique filenames for datasets (handle table_name collisions) + dataset_filenames: dict[int, str] = {} + seen_table_names: dict[str, int] = {} # table_name -> first dataset_id + + for ds_id, dataset in datasets.items(): + table_name = dataset.table_name + if table_name in seen_table_names: + # Collision! Use UUID suffix for uniqueness + uuid_suffix = str(dataset.uuid)[:8] + filename = f"{table_name}-{uuid_suffix}" + logger.info( + "Table name collision for '%s', using '%s'", table_name, filename + ) + else: + filename = table_name + seen_table_names[table_name] = ds_id + dataset_filenames[ds_id] = filename + + # Export datasets + multi_dataset = len(datasets) > 1 + + if multi_dataset: + # Multiple datasets: use datasets/ and data/ folders + for ds_id, dataset in datasets.items(): + filename = dataset_filenames[ds_id] + needs_data = ds_id in datasets_needing_data + is_preserved = ds_id in preserved_virtual + data_file = f"{filename}.parquet" if needs_data else None + + # Export YAML + dataset_config = export_dataset_yaml( + dataset, + data_file=data_file, + preserve_virtual=is_preserved, + ) + yield ( + f"datasets/{filename}.yaml", + _make_yaml_generator(dataset_config), + ) + + # Export data only for datasets that need it + if self._export_data and needs_data: + data = export_dataset_data(dataset, self._sample_rows) + if data: + yield ( + f"data/{data_file}", + _make_bytes_generator(data), + ) + + elif len(datasets) == 1: + # Single dataset: use dataset.yaml and data.parquet at root + ds_id = next(iter(datasets.keys())) + dataset = datasets[ds_id] + needs_data = ds_id in datasets_needing_data + is_preserved = ds_id in preserved_virtual + data_file = "data.parquet" if needs_data else None + + dataset_config = export_dataset_yaml( + dataset, + data_file=data_file, + preserve_virtual=is_preserved, + ) + yield ("dataset.yaml", _make_yaml_generator(dataset_config)) + + if self._export_data and needs_data: + data = export_dataset_data(dataset, self._sample_rows) + if data: + yield ("data.parquet", _make_bytes_generator(data)) + + # Export charts + for chart in charts: + dataset_uuid = chart_to_dataset_uuid.get(chart.id, "") + chart_config = export_chart(chart, dataset_uuid) + filename = sanitize_filename(chart.slice_name) + ".yaml" + yield (f"charts/{filename}", _make_yaml_generator(chart_config)) + + # Export dashboard + dashboard_config = export_dashboard_yaml( + self._dashboard, chart_id_to_uuid, dataset_id_to_uuid + ) + yield ("dashboard.yaml", _make_yaml_generator(dashboard_config)) diff --git a/superset/commands/database/importers/v1/utils.py b/superset/commands/database/importers/v1/utils.py index 2b2fd2ac3fd..203c3b2555a 100644 --- a/superset/commands/database/importers/v1/utils.py +++ b/superset/commands/database/importers/v1/utils.py @@ -34,7 +34,7 @@ from superset.utils import json logger = logging.getLogger(__name__) -def import_database( +def import_database( # noqa: C901 config: dict[str, Any], overwrite: bool = False, ignore_permissions: bool = False, @@ -59,8 +59,14 @@ def import_database( except SupersetSecurityException as exc: raise ImportFailedError(exc.message) from exc # https://github.com/apache/superset/pull/16756 renamed ``csv`` to ``file``. - config["allow_file_upload"] = config.pop("allow_csv_upload") - if "schemas_allowed_for_csv_upload" in config["extra"]: + # Handle both old and new field names, defaulting to True for examples database + if "allow_csv_upload" in config: + config["allow_file_upload"] = config.pop("allow_csv_upload") + elif "allow_file_upload" not in config: + # Default to True for backward compatibility + config["allow_file_upload"] = True + + if "schemas_allowed_for_csv_upload" in config.get("extra", {}): config["extra"]["schemas_allowed_for_file_upload"] = config["extra"].pop( "schemas_allowed_for_csv_upload" ) diff --git a/superset/commands/database/test_connection.py b/superset/commands/database/test_connection.py index fb922038ee5..1395994d73e 100644 --- a/superset/commands/database/test_connection.py +++ b/superset/commands/database/test_connection.py @@ -95,7 +95,7 @@ class TestConnectionDatabaseCommand(BaseCommand): ex_str = "" url = make_url_safe(self._uri) - engine = url.get_backend_name() + engine_name = url.get_backend_name() serialized_encrypted_extra = self._properties.get( "masked_encrypted_extra", @@ -136,7 +136,7 @@ class TestConnectionDatabaseCommand(BaseCommand): "test_connection_attempt", ssh_tunnel_properties, ), - engine=engine, + engine=engine_name, ) with database.get_sqla_engine() as engine: @@ -174,7 +174,7 @@ class TestConnectionDatabaseCommand(BaseCommand): "test_connection_success", ssh_tunnel_properties, ), - engine=engine, + engine=engine_name, ) except (NoSuchModuleError, ModuleNotFoundError) as ex: @@ -184,12 +184,12 @@ class TestConnectionDatabaseCommand(BaseCommand): ssh_tunnel_properties, ex, ), - engine=engine, + engine=engine_name, ) raise DatabaseTestConnectionDriverError( message=_( "Could not load database driver for: %(engine)s", - engine=engine, + engine=engine_name, ), ) from ex except DBAPIError as ex: @@ -199,7 +199,7 @@ class TestConnectionDatabaseCommand(BaseCommand): ssh_tunnel_properties, ex, ), - engine=engine, + engine=engine_name, ) if not database: @@ -218,7 +218,7 @@ class TestConnectionDatabaseCommand(BaseCommand): ssh_tunnel_properties, ex, ), - engine=engine, + engine=engine_name, ) raise DatabaseSecurityUnsafeError(message=str(ex)) from ex except (SupersetTimeoutException, SSHTunnelingNotEnabledError) as ex: @@ -228,7 +228,7 @@ class TestConnectionDatabaseCommand(BaseCommand): ssh_tunnel_properties, ex, ), - engine=engine, + engine=engine_name, ) # bubble up the exception to return proper status code raise @@ -246,7 +246,7 @@ class TestConnectionDatabaseCommand(BaseCommand): ssh_tunnel_properties, ex, ), - engine=engine, + engine=engine_name, ) errors = database.db_engine_spec.extract_errors(ex, self._context) raise DatabaseTestConnectionUnexpectedError(errors) from ex diff --git a/superset/commands/database/uploaders/base.py b/superset/commands/database/uploaders/base.py index 18b4f8024f4..f8e2b389d84 100644 --- a/superset/commands/database/uploaders/base.py +++ b/superset/commands/database/uploaders/base.py @@ -159,6 +159,12 @@ class UploadCommand(BaseCommand): if not self._model: return + self._table_name, self._schema = ( + self._model.db_engine_spec.normalize_table_name_for_upload( + self._table_name, self._schema + ) + ) + self._reader.read(self._file, self._model, self._table_name, self._schema) sqla_table = ( diff --git a/superset/commands/importers/v1/examples.py b/superset/commands/importers/v1/examples.py index ab548d35409..19fe811044a 100644 --- a/superset/commands/importers/v1/examples.py +++ b/superset/commands/importers/v1/examples.py @@ -14,11 +14,11 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. +import logging from typing import Any, Optional from marshmallow import Schema from sqlalchemy.exc import MultipleResultsFound -from sqlalchemy.sql import select from superset import db from superset.charts.schemas import ImportV1ChartSchema @@ -36,15 +36,69 @@ from superset.commands.dataset.importers.v1 import ImportDatasetsCommand from superset.commands.dataset.importers.v1.utils import import_dataset from superset.commands.exceptions import CommandException from superset.commands.importers.v1 import ImportModelsCommand +from superset.commands.importers.v1.utils import ( + safe_insert_dashboard_chart_relationships, +) from superset.daos.base import BaseDAO from superset.dashboards.schemas import ImportV1DashboardSchema from superset.databases.schemas import ImportV1DatabaseSchema from superset.datasets.schemas import ImportV1DatasetSchema -from superset.models.dashboard import dashboard_slices +from superset.exceptions import QueryClauseValidationException +from superset.models.core import Database +from superset.sql.parse import transpile_to_dialect from superset.utils.core import get_example_default_schema -from superset.utils.database import get_example_database from superset.utils.decorators import transaction +logger = logging.getLogger(__name__) + + +def transpile_virtual_dataset_sql(config: dict[str, Any], database_id: int) -> None: + """ + Transpile virtual dataset SQL to the target database dialect. + + This ensures that virtual datasets exported from one database type + (e.g., PostgreSQL) can be loaded into a different database type + (e.g., MySQL, DuckDB, SQLite). + + Args: + config: Dataset configuration dict (modified in place) + database_id: ID of the target database + """ + sql = config.get("sql") + if not sql: + return + + database = db.session.query(Database).get(database_id) + if not database: + logger.warning("Database %s not found, skipping SQL transpilation", database_id) + return + + target_engine = database.db_engine_spec.engine + source_engine = config.get("source_db_engine") + if target_engine == source_engine: + logger.info("Source and target dialects are identical, skipping transpilation") + return + + try: + transpiled_sql = transpile_to_dialect(sql, target_engine, source_engine) + if transpiled_sql != sql: + logger.info( + "Transpiled virtual dataset SQL for '%s' from %s to %s dialect", + config.get("table_name", "unknown"), + source_engine or "generic", + target_engine, + ) + config["sql"] = transpiled_sql + except QueryClauseValidationException as ex: + logger.warning( + "Could not transpile SQL for dataset '%s' from %s to %s: %s. " + "Using original SQL which may not be compatible.", + config.get("table_name", "unknown"), + source_engine or "generic", + target_engine, + ex, + ) + class ImportExamplesCommand(ImportModelsCommand): """Import examples""" @@ -105,27 +159,24 @@ class ImportExamplesCommand(ImportModelsCommand): database_ids[str(database.uuid)] = database.id # import datasets - # If database_uuid is not in the list of UUIDs it means that the examples - # database was created before its UUID was frozen, so it has a random UUID. - # We need to determine its ID so we can point the dataset to it. - examples_db = get_example_database() dataset_info: dict[str, dict[str, Any]] = {} for file_name, config in configs.items(): if file_name.startswith("datasets/"): # find the ID of the corresponding database if config["database_uuid"] not in database_ids: - if examples_db is None: - raise Exception( # pylint: disable=broad-exception-raised - "Cannot find examples database" - ) - config["database_id"] = examples_db.id - else: - config["database_id"] = database_ids[config["database_uuid"]] + raise Exception( # pylint: disable=broad-exception-raised + f"Database UUID {config['database_uuid']} not found. " + "Please ensure the database config is present." + ) + config["database_id"] = database_ids[config["database_uuid"]] # set schema if config["schema"] is None: config["schema"] = get_example_default_schema() + # transpile virtual dataset SQL to target database dialect + transpile_virtual_dataset_sql(config, config["database_id"]) + try: dataset = import_dataset( config, @@ -164,11 +215,6 @@ class ImportExamplesCommand(ImportModelsCommand): ) chart_ids[str(chart.uuid)] = chart.id - # store the existing relationship between dashboards and charts - existing_relationships = db.session.execute( - select([dashboard_slices.c.dashboard_id, dashboard_slices.c.slice_id]) - ).fetchall() - # import dashboards dashboard_chart_ids: list[tuple[int, int]] = [] for file_name, config in configs.items(): @@ -187,12 +233,7 @@ class ImportExamplesCommand(ImportModelsCommand): for uuid in find_chart_uuids(config["position"]): chart_id = chart_ids[uuid] - if (dashboard.id, chart_id) not in existing_relationships: - dashboard_chart_ids.append((dashboard.id, chart_id)) + dashboard_chart_ids.append((dashboard.id, chart_id)) # set ref in the dashboard_slices table - values = [ - {"dashboard_id": dashboard_id, "slice_id": chart_id} - for (dashboard_id, chart_id) in dashboard_chart_ids - ] - db.session.execute(dashboard_slices.insert(), values) + safe_insert_dashboard_chart_relationships(dashboard_chart_ids) diff --git a/superset/commands/importers/v1/utils.py b/superset/commands/importers/v1/utils.py index 9f7621e2488..3aeb586997c 100644 --- a/superset/commands/importers/v1/utils.py +++ b/superset/commands/importers/v1/utils.py @@ -29,6 +29,7 @@ from superset.commands.importers.exceptions import IncorrectVersionError from superset.databases.ssh_tunnel.models import SSHTunnel from superset.extensions import feature_flag_manager from superset.models.core import Database +from superset.models.dashboard import dashboard_slices from superset.tags.models import Tag, TaggedObject from superset.utils.core import check_is_safe_zip from superset.utils.decorators import transaction @@ -320,6 +321,48 @@ def import_tag( return new_tag_ids +def safe_insert_dashboard_chart_relationships( + dashboard_chart_ids: list[tuple[int, int]], +) -> None: + """ + Safely insert dashboard-chart relationships, handling duplicates. + + This function checks for existing relationships and only inserts new ones + to avoid duplicate key constraint errors. + """ + from sqlalchemy.sql import select + + if not dashboard_chart_ids: + return + + # Get existing relationships only for dashboards being updated + dashboard_ids = {dashboard_id for dashboard_id, _ in dashboard_chart_ids} + existing_relationships = db.session.execute( + select([dashboard_slices.c.dashboard_id, dashboard_slices.c.slice_id]).where( + dashboard_slices.c.dashboard_id.in_(dashboard_ids) + ) + ).fetchall() + existing_relationships_set = {(row[0], row[1]) for row in existing_relationships} + + # Filter out relationships that already exist + new_relationships = [ + (dashboard_id, chart_id) + for dashboard_id, chart_id in dashboard_chart_ids + if (dashboard_id, chart_id) not in existing_relationships_set + ] + + # Insert new relationships in bulk, deduplicating to avoid unique constraint issues + + if unique_new_relationships := set(new_relationships): + db.session.execute( + dashboard_slices.insert(), + [ + {"dashboard_id": dashboard_id, "slice_id": chart_id} + for dashboard_id, chart_id in unique_new_relationships + ], + ) + + def get_resource_mappings_batched( model_class: Type[Any], batch_size: int = 1000, diff --git a/superset/config.py b/superset/config.py index 7b188370e77..5e66fe40f48 100644 --- a/superset/config.py +++ b/superset/config.py @@ -436,6 +436,7 @@ LANGUAGES = { "sl": {"flag": "si", "name": "Slovenian"}, "nl": {"flag": "nl", "name": "Dutch"}, "uk": {"flag": "uk", "name": "Ukranian"}, + "mi": {"flag": "nz", "name": "Māori"}, } # Turning off i18n by default as translation in most languages are # incomplete and not well maintained. @@ -519,143 +520,268 @@ CURRENCIES = ["USD", "EUR", "GBP", "INR", "MXN", "JPY", "CNY"] # --------------------------------------------------- # Feature flags # --------------------------------------------------- -# Feature flags that are set by default go here. Their values can be -# overwritten by those specified under FEATURE_FLAGS in superset_config.py -# For example, DEFAULT_FEATURE_FLAGS = { 'FOO': True, 'BAR': False } here -# and FEATURE_FLAGS = { 'BAR': True, 'BAZ': True } in superset_config.py -# will result in combined feature flags of { 'FOO': True, 'BAR': True, 'BAZ': True } +# Feature flags control optional functionality in Superset. They can be set in +# superset_config.py to override the defaults below. +# +# Example: FEATURE_FLAGS = { 'ALERT_REPORTS': True } +# +# Each flag is annotated with: +# @lifecycle: development | testing | stable | deprecated +# @docs: URL to documentation (optional) +# @category: runtime_config | path_to_deprecation (for stable flags) +# +# Lifecycle meanings: +# - development: Unfinished, for dev environments only +# - testing: Complete but being validated, may have bugs +# - stable: Production-ready, tested and supported +# - deprecated: Will be removed in a future major release + DEFAULT_FEATURE_FLAGS: dict[str, bool] = { - # When using a recent version of Druid that supports JOINs turn this on - "DRUID_JOINS": False, - "DYNAMIC_PLUGINS": False, - "ENABLE_TEMPLATE_PROCESSING": False, - # Allow for javascript controls components - # this enables programmers to customize certain charts (like the - # geospatial ones) by inputting javascript in controls. This exposes - # an XSS security vulnerability - "ENABLE_JAVASCRIPT_CONTROLS": False, # deprecated - # Experimental PyArrow engine for CSV parsing (may have issues with dates/nulls) - "CSV_UPLOAD_PYARROW_ENGINE": False, - # When this feature is enabled, nested types in Presto will be - # expanded into extra columns and/or arrays. This is experimental, - # and doesn't work with all nested types. - "PRESTO_EXPAND_DATA": False, - # Exposes API endpoint to compute thumbnails - "THUMBNAILS": False, - # Enables the endpoints to cache and retrieve dashboard screenshots via webdriver. - # Requires configuring Celery and a cache using THUMBNAIL_CACHE_CONFIG. - "ENABLE_DASHBOARD_SCREENSHOT_ENDPOINTS": False, - # Generate screenshots (PDF or JPG) of dashboards using the web driver. - # When disabled, screenshots are generated on the fly by the browser. - # This feature flag is used by the download feature in the dashboard view. - # It is dependent on ENABLE_DASHBOARD_SCREENSHOT_ENDPOINT being enabled. - "ENABLE_DASHBOARD_DOWNLOAD_WEBDRIVER_SCREENSHOT": False, - "TAGGING_SYSTEM": False, - "SQLLAB_BACKEND_PERSISTENCE": True, - "LISTVIEWS_DEFAULT_CARD_VIEW": False, - # When True, this escapes HTML (rather than rendering it) in Markdown components - "ESCAPE_MARKDOWN_HTML": False, - "DASHBOARD_VIRTUALIZATION": True, - # This feature flag is stil in beta and is not recommended for production use. - "GLOBAL_ASYNC_QUERIES": False, - "EMBEDDED_SUPERSET": False, - # Enables Alerts and reports new implementation - "ALERT_REPORTS": False, - "ALERT_REPORT_TABS": False, - "ALERT_REPORTS_FILTER": False, - "ALERT_REPORT_SLACK_V2": False, - "ALERT_REPORT_WEBHOOK": False, - "DASHBOARD_RBAC": False, - "ENABLE_ADVANCED_DATA_TYPES": False, - # Enabling ALERTS_ATTACH_REPORTS, the system sends email and slack message - # with screenshot and link - # Disables ALERTS_ATTACH_REPORTS, the system DOES NOT generate screenshot - # for report with type 'alert' and sends email and slack message with only link; - # for report with type 'report' still send with email and slack message with - # screenshot and link - "ALERTS_ATTACH_REPORTS": True, - # Allow users to export full CSV of table viz type. - # This could cause the server to run out of memory or compute. - "ALLOW_FULL_CSV_EXPORT": False, - "ALLOW_ADHOC_SUBQUERY": False, - "USE_ANALOGOUS_COLORS": False, - # Apply RLS rules to SQL Lab queries. This requires parsing and manipulating the - # query, and might break queries and/or allow users to bypass RLS. Use with care! - "RLS_IN_SQLLAB": False, - # Try to optimize SQL queries — for now only predicate pushdown is supported. - "OPTIMIZE_SQL": False, - # When impersonating a user, use the email prefix instead of the username - "IMPERSONATE_WITH_EMAIL_PREFIX": False, - # Enable caching per impersonation key (e.g username) in a datasource where user - # impersonation is enabled - "CACHE_IMPERSONATION": False, - # Enable caching per user key for Superset cache (not database cache impersonation) - "CACHE_QUERY_BY_USER": False, - # Enable sharing charts with embedding - "EMBEDDABLE_CHARTS": True, - "DRILL_TO_DETAIL": True, # deprecated - "DRILL_BY": True, - "DATAPANEL_CLOSED_BY_DEFAULT": False, - # When you open the dashboard, the filter panel will be closed - "FILTERBAR_CLOSED_BY_DEFAULT": False, - # The feature is off by default, and currently only supported in Presto and Postgres, # noqa: E501 - # and Bigquery. - # It also needs to be enabled on a per-database basis, by adding the key/value pair - # `cost_estimate_enabled: true` to the database `extra` attribute. - "ESTIMATE_QUERY_COST": False, - # Allow users to enable ssh tunneling when creating a DB. - # Users must check whether the DB engine supports SSH Tunnels - # otherwise enabling this flag won't have any effect on the DB. - "SSH_TUNNELING": False, - "AVOID_COLORS_COLLISION": True, - # Do not show user info in the menu - "MENU_HIDE_USER_INFO": False, - # Allows users to add a ``superset://`` DB that can query across databases. This is - # an experimental feature with potential security and performance risks, so use with - # caution. If the feature is enabled you can also set a limit for how much data is - # returned from each database in the ``SUPERSET_META_DB_LIMIT`` configuration value - # in this file. - "ENABLE_SUPERSET_META_DB": False, - # Set to True to replace Selenium with Playwright to execute reports and thumbnails. - # Unlike Selenium, Playwright reports support deck.gl visualizations - # Enabling this feature flag requires installing "playwright" pip package - "PLAYWRIGHT_REPORTS_AND_THUMBNAILS": False, - # Set to True to enable experimental chart plugins - "CHART_PLUGINS_EXPERIMENTAL": False, - # Regardless of database configuration settings, force SQLLAB to run async - # using Celery - "SQLLAB_FORCE_RUN_ASYNC": False, - # Set to True to to enable factory resent CLI command - "ENABLE_FACTORY_RESET_COMMAND": False, - # Whether Superset should use Slack avatars for users. - # If on, you'll want to add "https://avatars.slack-edge.com" to the list of allowed - # domains in your TALISMAN_CONFIG - "SLACK_ENABLE_AVATARS": False, - # Adds a theme editor as a modal dialog in the navbar. Allows people to type in JSON - # Enables CSS Templates functionality in Settings menu and dashboard forms. - # When disabled, users can still add custom CSS to dashboards but cannot use - # pre-built CSS templates. - "CSS_TEMPLATES": True, - # Allow users to optionally specify date formats in email subjects, which will - # be parsed if enabled - "DATE_FORMAT_IN_EMAIL_SUBJECT": False, - # Allow metrics and columns to be grouped into (potentially nested) folders in the - # chart builder - "DATASET_FOLDERS": False, - # Enable Table V2 Viz plugin + # ================================================================= + # IN DEVELOPMENT + # ================================================================= + # These features are considered unfinished and should only be used + # on development environments. + # ----------------------------------------------------------------- + # Enables Table V2 (AG Grid) viz plugin + # @lifecycle: development "AG_GRID_TABLE_ENABLED": False, - # Enable Table v2 time comparison feature - "TABLE_V2_TIME_COMPARISON_ENABLED": False, - # Enable Superset extensions, which allow users to add custom functionality - # to Superset without modifying the core codebase. - "ENABLE_EXTENSIONS": False, + # Enables experimental tabs UI for Alerts and Reports + # @lifecycle: development + "ALERT_REPORT_TABS": False, + # Enables experimental chart plugins + # @lifecycle: development + "CHART_PLUGINS_EXPERIMENTAL": False, + # Experimental PyArrow engine for CSV parsing (may have issues with dates/nulls) + # @lifecycle: development + "CSV_UPLOAD_PYARROW_ENGINE": False, + # Allow metrics and columns to be grouped into folders in the chart builder + # @lifecycle: development + "DATASET_FOLDERS": False, # Enable support for date range timeshifts (e.g., "2015-01-03 : 2015-01-04") # in addition to relative timeshifts (e.g., "1 day ago") + # @lifecycle: development "DATE_RANGE_TIMESHIFTS_ENABLED": False, + # Enables advanced data type support + # @lifecycle: development + "ENABLE_ADVANCED_DATA_TYPES": False, + # Enable Superset extensions for custom functionality without modifying core + # @lifecycle: development + "ENABLE_EXTENSIONS": False, # Enable Matrixify feature for matrix-style chart layouts + # @lifecycle: development "MATRIXIFY": False, + # Try to optimize SQL queries — for now only predicate pushdown is supported + # @lifecycle: development + "OPTIMIZE_SQL": False, + # Expand nested types in Presto into extra columns/arrays. Experimental, + # doesn't work with all nested types. + # @lifecycle: development + "PRESTO_EXPAND_DATA": False, + # Enable Table V2 time comparison feature + # @lifecycle: development + "TABLE_V2_TIME_COMPARISON_ENABLED": False, + # Enables the tagging system for organizing assets + # @lifecycle: development + "TAGGING_SYSTEM": False, + # ================================================================= + # IN TESTING + # ================================================================= + # These features are finished but currently being tested. + # They are usable, but may still contain some bugs. + # ----------------------------------------------------------------- + # Enables filter functionality in Alerts and Reports + # @lifecycle: testing + "ALERT_REPORTS_FILTER": False, + # Enables Alerts and Reports functionality + # @lifecycle: testing + # @docs: https://superset.apache.org/docs/configuration/alerts-reports + "ALERT_REPORTS": False, + # Enables Slack V2 integration for Alerts and Reports + # @lifecycle: testing + "ALERT_REPORT_SLACK_V2": False, + # Enables webhook integration for Alerts and Reports + # @lifecycle: testing + "ALERT_REPORT_WEBHOOK": False, + # Allow users to export full CSV of table viz type. + # Warning: Could cause server memory/compute issues with large datasets. + # @lifecycle: testing + "ALLOW_FULL_CSV_EXPORT": False, + # Enable caching per impersonation key in datasources with user impersonation + # @lifecycle: testing + "CACHE_IMPERSONATION": False, + # Allow users to optionally specify date formats in email subjects + # @lifecycle: testing + # @docs: https://superset.apache.org/docs/configuration/alerts-reports + "DATE_FORMAT_IN_EMAIL_SUBJECT": False, + # Enable dynamic plugin loading + # @lifecycle: testing + "DYNAMIC_PLUGINS": False, + # Enables endpoints to cache and retrieve dashboard screenshots via webdriver. + # Requires Celery and THUMBNAIL_CACHE_CONFIG. + # @lifecycle: testing + "ENABLE_DASHBOARD_SCREENSHOT_ENDPOINTS": False, + # Generate screenshots (PDF/JPG) of dashboards using web driver. + # Depends on ENABLE_DASHBOARD_SCREENSHOT_ENDPOINTS. + # @lifecycle: testing + "ENABLE_DASHBOARD_DOWNLOAD_WEBDRIVER_SCREENSHOT": False, + # Allows users to add a superset:// DB that can query across databases. + # Experimental with potential security/performance risks. + # See SUPERSET_META_DB_LIMIT. + # @lifecycle: testing + # @docs: https://superset.apache.org/docs/configuration/databases/#querying-across-databases + "ENABLE_SUPERSET_META_DB": False, + # Enable query cost estimation. Supported in Presto, Postgres, and BigQuery. + # Requires `cost_estimate_enabled: true` in database `extra` attribute. + # @lifecycle: testing + "ESTIMATE_QUERY_COST": False, + # Enable async queries for dashboards and Explore via WebSocket. + # Requires Redis 5.0+ and Celery workers. + # @lifecycle: testing + # @docs: https://superset.apache.org/docs/contributing/misc#async-chart-queries + "GLOBAL_ASYNC_QUERIES": False, + # When impersonating a user, use the email prefix instead of username + # @lifecycle: testing + "IMPERSONATE_WITH_EMAIL_PREFIX": False, + # Replace Selenium with Playwright for reports and thumbnails. + # Supports deck.gl visualizations. Requires playwright pip package. + # @lifecycle: testing + "PLAYWRIGHT_REPORTS_AND_THUMBNAILS": False, + # Apply RLS rules to SQL Lab queries. Requires query parsing/manipulation. + # May break queries or allow RLS bypass. Use with care! + # @lifecycle: testing + "RLS_IN_SQLLAB": False, + # Allow users to enable SSH tunneling when creating a DB connection. + # DB engine must support SSH Tunnels. + # @lifecycle: testing + # @docs: https://superset.apache.org/docs/configuration/setup-ssh-tunneling + "SSH_TUNNELING": False, + # Use analogous colors in charts + # @lifecycle: testing + "USE_ANALOGOUS_COLORS": False, + # ================================================================= + # STABLE - PATH TO DEPRECATION + # ================================================================= + # These flags are stable and on path to becoming default behavior, + # after which the flag will be deprecated. + # ----------------------------------------------------------------- + # Enables dashboard virtualization for improved performance + # @lifecycle: stable + # @category: path_to_deprecation + "DASHBOARD_VIRTUALIZATION": True, + # ================================================================= + # STABLE - RUNTIME CONFIGURATION + # ================================================================= + # These flags act as runtime configuration options. They are stable + # but will be retained as configuration options rather than deprecated. + # ----------------------------------------------------------------- + # When enabled, alerts send email/slack with screenshot AND link. + # When disabled, alerts send only link; reports still send screenshot. + # @lifecycle: stable + # @category: runtime_config + "ALERTS_ATTACH_REPORTS": True, + # Allow ad-hoc subqueries in SQL Lab + # @lifecycle: stable + # @category: runtime_config + "ALLOW_ADHOC_SUBQUERY": False, + # Enable caching per user key for Superset cache + # @lifecycle: stable + # @category: runtime_config + "CACHE_QUERY_BY_USER": False, + # Enables CSS Templates in Settings menu and dashboard forms + # @lifecycle: stable + # @category: runtime_config + "CSS_TEMPLATES": True, + # Role-based access control for dashboards + # @lifecycle: stable + # @category: runtime_config + # @docs: https://superset.apache.org/docs/using-superset/creating-your-first-dashboard + "DASHBOARD_RBAC": False, + # Data panel closed by default in chart builder + # @lifecycle: stable + # @category: runtime_config + "DATAPANEL_CLOSED_BY_DEFAULT": False, + # Enable drill-by functionality in charts + # @lifecycle: stable + # @category: runtime_config + "DRILL_BY": True, + # Enable Druid JOINs (requires Druid version with JOIN support) + # @lifecycle: stable + # @category: runtime_config + "DRUID_JOINS": False, + # Enable sharing charts with embedding + # @lifecycle: stable + # @category: runtime_config + "EMBEDDABLE_CHARTS": True, + # Enable embedded Superset functionality + # @lifecycle: stable + # @category: runtime_config + "EMBEDDED_SUPERSET": False, + # Enable Jinja templating in SQL queries + # @lifecycle: stable + # @category: runtime_config + "ENABLE_TEMPLATE_PROCESSING": False, + # Escape HTML in Markdown components (rather than rendering it) + # @lifecycle: stable + # @category: runtime_config + "ESCAPE_MARKDOWN_HTML": False, + # Filter bar closed by default when opening dashboard + # @lifecycle: stable + # @category: runtime_config + "FILTERBAR_CLOSED_BY_DEFAULT": False, # Force garbage collection after every request + # @lifecycle: stable + # @category: runtime_config "FORCE_GARBAGE_COLLECTION_AFTER_EVERY_REQUEST": False, + # Use card view as default in list views + # @lifecycle: stable + # @category: runtime_config + "LISTVIEWS_DEFAULT_CARD_VIEW": False, + # Hide user info in the navigation menu + # @lifecycle: stable + # @category: runtime_config + "MENU_HIDE_USER_INFO": False, + # Use Slack avatars for users. Requires adding slack-edge.com to TALISMAN_CONFIG. + # @lifecycle: stable + # @category: runtime_config + "SLACK_ENABLE_AVATARS": False, + # Enable SQL Lab backend persistence for query state + # @lifecycle: stable + # @category: runtime_config + "SQLLAB_BACKEND_PERSISTENCE": True, + # Force SQL Lab to run async via Celery regardless of database settings + # @lifecycle: stable + # @category: runtime_config + "SQLLAB_FORCE_RUN_ASYNC": False, + # Exposes API endpoint to compute thumbnails + # @lifecycle: stable + # @category: runtime_config + # @docs: https://superset.apache.org/docs/configuration/cache + "THUMBNAILS": False, + # ================================================================= + # STABLE - INTERNAL/ADMIN + # ================================================================= + # These flags are for internal use or administrative purposes. + # ----------------------------------------------------------------- + # Enable factory reset CLI command + # @lifecycle: stable + # @category: internal + "ENABLE_FACTORY_RESET_COMMAND": False, + # ================================================================= + # DEPRECATED + # ================================================================= + # These flags default to True and will be removed in a future major + # release. Set to True in your config to avoid unexpected changes. + # ----------------------------------------------------------------- + # Avoid color collisions in charts by using distinct colors + # @lifecycle: deprecated + "AVOID_COLORS_COLLISION": True, + # Enable drill-to-detail functionality in charts + # @lifecycle: deprecated + "DRILL_TO_DETAIL": True, + # Allow JavaScript in chart controls. WARNING: XSS security vulnerability! + # @lifecycle: deprecated + "ENABLE_JAVASCRIPT_CONTROLS": False, } # ------------------------------ @@ -777,6 +903,8 @@ EXTRA_CATEGORICAL_COLOR_SCHEMES: list[dict[str, Any]] = [] THEME_DEFAULT: Theme = { "token": { # Brand + # Application name for window titles + "brandAppName": APP_NAME, "brandLogoAlt": "Apache Superset", "brandLogoUrl": APP_ICON, "brandLogoMargin": "18px 0", @@ -794,7 +922,7 @@ THEME_DEFAULT: Theme = { "colorInfo": "#66bcfe", # Fonts "fontUrls": [], - "fontFamily": "Inter, Helvetica, Arial", + "fontFamily": "Inter, Helvetica, Arial, sans-serif", "fontFamilyCode": "'Fira Code', 'Courier New', monospace", # Extra tokens "transitionTiming": 0.3, @@ -804,6 +932,8 @@ THEME_DEFAULT: Theme = { "fontWeightNormal": "400", "fontWeightLight": "300", "fontWeightStrong": "500", + # Editor selection color (for SQL Lab text highlighting) + "colorEditorSelection": "#fff5cf", }, "algorithm": "default", } @@ -813,6 +943,11 @@ THEME_DEFAULT: Theme = { # Set to None to disable dark mode THEME_DARK: Optional[Theme] = { **THEME_DEFAULT, + "token": { + **THEME_DEFAULT["token"], + # Darker selection color for dark mode + "colorEditorSelection": "#5c4d1a", + }, "algorithm": "dark", } diff --git a/superset/dashboards/api.py b/superset/dashboards/api.py index 723f4173319..4592138866e 100644 --- a/superset/dashboards/api.py +++ b/superset/dashboards/api.py @@ -60,6 +60,7 @@ from superset.commands.dashboard.exceptions import ( DashboardUpdateFailedError, ) from superset.commands.dashboard.export import ExportDashboardsCommand +from superset.commands.dashboard.export_example import ExportExampleCommand from superset.commands.dashboard.fave import AddFavoriteDashboardCommand from superset.commands.dashboard.importers.dispatcher import ImportDashboardsCommand from superset.commands.dashboard.permalink.create import CreateDashboardPermalinkCommand @@ -242,6 +243,7 @@ class DashboardRestApi(CustomTagsOptimizationMixin, BaseSupersetModelRestApi): "put_filters", "put_chart_customizations", "put_colors", + "export_as_example", } resource_name = "dashboard" allow_browser_login = True @@ -1226,6 +1228,96 @@ class DashboardRestApi(CustomTagsOptimizationMixin, BaseSupersetModelRestApi): response.set_cookie(token, "done", max_age=600) return response + @expose("//export_as_example/", methods=("GET",)) + @protect() + @safe + @permission_name("export") + @statsd_metrics + @event_logger.log_this_with_context( + action=lambda self, *args, **kwargs: f"{self.__class__.__name__}" + f".export_as_example", + log_to_statsd=False, + ) + def export_as_example(self, pk: int) -> Response: + """Export dashboard as example bundle (Parquet + YAML ZIP). + --- + get: + summary: Export dashboard as example bundle + description: >- + Exports a dashboard with its charts and datasets in the example + format used by the Superset example loading system. The export + includes Parquet data files and YAML configuration files. + parameters: + - in: path + schema: + type: integer + name: pk + description: The dashboard id + - in: query + name: export_data + schema: + type: boolean + default: true + description: Whether to include Parquet data files + - in: query + name: sample_rows + schema: + type: integer + description: Limit data export to this many rows per dataset + responses: + 200: + description: Example bundle ZIP file + content: + application/zip: + schema: + type: string + format: binary + 401: + $ref: '#/components/responses/401' + 403: + $ref: '#/components/responses/403' + 404: + $ref: '#/components/responses/404' + 500: + $ref: '#/components/responses/500' + """ + # Get optional query params + export_data = request.args.get("export_data", "true").lower() == "true" + sample_rows = request.args.get("sample_rows", type=int) + + # Build ZIP from command output + buf = BytesIO() + try: + with ZipFile(buf, "w") as bundle: + for filename, content_fn in ExportExampleCommand( + pk, export_data, sample_rows + ).run(): + bundle.writestr(filename, content_fn()) + except DashboardNotFoundError: + return self.response_404() + + buf.seek(0) + + # Generate filename from dashboard slug or ID + if dashboard := self.datamodel.get(pk): + # Sanitize slug for filename + slug = dashboard.slug or f"dashboard_{pk}" + safe_name = "".join(c if c.isalnum() or c in "._-" else "_" for c in slug) + else: + safe_name = f"dashboard_{pk}" + + filename = f"{safe_name}_example.zip" + + response = send_file( + buf, + mimetype="application/zip", + as_attachment=True, + download_name=filename, + ) + if token := request.args.get("token"): + response.set_cookie(token, "done", max_age=600) + return response + @expose("//cache_dashboard_screenshot/", methods=("POST",)) @validate_feature_flags(["THUMBNAILS", "ENABLE_DASHBOARD_SCREENSHOT_ENDPOINTS"]) @protect() diff --git a/superset/databases/api.py b/superset/databases/api.py index b0f29c5247a..e9178d1f24e 100644 --- a/superset/databases/api.py +++ b/superset/databases/api.py @@ -218,6 +218,7 @@ class DatabaseRestApi(BaseSupersetModelRestApi): "changed_by.last_name", "created_by.first_name", "created_by.last_name", + "configuration_method", "database_name", "explore_database_id", "expose_in_sqllab", diff --git a/superset/databases/schemas.py b/superset/databases/schemas.py index 105496efa4c..199da14b63c 100644 --- a/superset/databases/schemas.py +++ b/superset/databases/schemas.py @@ -888,6 +888,13 @@ class ImportV1DatabaseSchema(Schema): is_managed_externally = fields.Boolean(allow_none=True, dump_default=False) external_url = fields.String(allow_none=True) ssh_tunnel = fields.Nested(DatabaseSSHTunnel, allow_none=True) + configuration_method = fields.Enum( + ConfigurationMethod, + by_value=True, + required=False, + allow_none=True, + load_default=ConfigurationMethod.SQLALCHEMY_FORM, + ) @validates_schema def validate_password(self, data: dict[str, Any], **kwargs: Any) -> None: diff --git a/superset/dataframe.py b/superset/dataframe.py index 5f3c0dc7798..0e7cba0bc3c 100644 --- a/superset/dataframe.py +++ b/superset/dataframe.py @@ -41,6 +41,9 @@ def df_to_records(dframe: pd.DataFrame) -> list[dict[str, Any]]: """ Convert a DataFrame to a set of records. + NaN values are converted to None for JSON compatibility. + This handles division by zero and other operations that produce NaN. + :param dframe: the DataFrame to convert :returns: a list of dictionaries reflecting each single row of the DataFrame """ @@ -52,6 +55,8 @@ def df_to_records(dframe: pd.DataFrame) -> list[dict[str, Any]]: for record in records: for key in record: - record[key] = _convert_big_integers(record[key]) + record[key] = ( + None if pd.isna(record[key]) else _convert_big_integers(record[key]) + ) return records diff --git a/superset/datasets/schemas.py b/superset/datasets/schemas.py index 8216c96caee..1506ef45d16 100644 --- a/superset/datasets/schemas.py +++ b/superset/datasets/schemas.py @@ -322,6 +322,8 @@ class ImportV1DatasetSchema(Schema): schema = fields.String(allow_none=True) catalog = fields.String(allow_none=True) sql = fields.String(allow_none=True) + # Source database engine for SQL transpilation (virtual datasets only) + source_db_engine = fields.String(allow_none=True, load_default=None) params = fields.Dict(allow_none=True) template_params = fields.Dict(allow_none=True) filter_select_enabled = fields.Boolean() @@ -338,6 +340,8 @@ class ImportV1DatasetSchema(Schema): normalize_columns = fields.Boolean(load_default=False) always_filter_main_dttm = fields.Boolean(load_default=False) folders = fields.List(fields.Nested(FolderSchema), required=False, allow_none=True) + # data_file is used by the example loading system to reference Parquet files + data_file = fields.String(allow_none=True, load_default=None) class GetOrCreateDatasetSchema(Schema): diff --git a/superset/db_engine_specs/METADATA_STATUS.md b/superset/db_engine_specs/METADATA_STATUS.md new file mode 100644 index 00000000000..7a206565849 --- /dev/null +++ b/superset/db_engine_specs/METADATA_STATUS.md @@ -0,0 +1,153 @@ + + +# Database Metadata Completeness Report + +This report is auto-generated by `python superset/db_engine_specs/lint_metadata.py --markdown`. +It tracks which database engine specs have complete metadata. + +## Summary + +- **Total engine specs:** 79 +- **With metadata:** 64 (81%) +- **All required fields:** 59 (74%) +- **Average completeness:** 65.4% + +## Required Fields + +These fields should be in every engine spec's `metadata` attribute: + +- `description` - Brief description of the database +- `category` - DatabaseCategory constant for grouping +- `pypi_packages` - Python packages needed for connection +- `connection_string` - SQLAlchemy URI template + +## Specs Needing Work + +| Engine | Module | Score | Missing Required | Missing Recommended | +|--------|--------|-------|------------------|---------------------| +| Azure Synapse | mssql.py | 0% | category, connection_string, description, pypi_packages | default_port, homepage_url, logo | +| ClickHouse Connect (Superset) | clickhouse.py | 0% | category, connection_string, description, pypi_packages | default_port, homepage_url, logo | +| ClickHouseBaseEngineSpec | clickhouse.py | 0% | category, connection_string, description, pypi_packages | default_port, homepage_url, logo | +| Databend | databend.py | 0% | category, connection_string, description, pypi_packages | default_port, homepage_url, logo | +| DatabendBaseEngineSpec | databend.py | 0% | category, connection_string, description, pypi_packages | default_port, homepage_url, logo | +| Databricks | databricks.py | 0% | category, connection_string, description, pypi_packages | default_port, homepage_url, logo | +| Databricks (legacy) | databricks.py | 0% | category, connection_string, description, pypi_packages | default_port, homepage_url, logo | +| Databricks SQL Endpoint | databricks.py | 0% | category, connection_string, description, pypi_packages | default_port, homepage_url, logo | +| DatabricksBaseEngineSpec | databricks.py | 0% | category, connection_string, description, pypi_packages | default_port, homepage_url, logo | +| DatabricksDynamicBaseEngineSpec | databricks.py | 0% | category, connection_string, description, pypi_packages | default_port, homepage_url, logo | +| MotherDuck | duckdb.py | 0% | category, connection_string, description, pypi_packages | default_port, homepage_url, logo | +| PostgreSQL | postgres.py | 0% | category, connection_string, description, pypi_packages | default_port, homepage_url, logo | +| PrestoBaseEngineSpec | presto.py | 0% | category, connection_string, description, pypi_packages | default_port, homepage_url, logo | +| Shillelagh | shillelagh.py | 0% | category, connection_string, description, pypi_packages | default_port, homepage_url, logo | +| Superset meta database | superset.py | 0% | category, connection_string, description, pypi_packages | default_port, homepage_url, logo | +| Apache Drill | drill.py | 51% | connection_string, pypi_packages | default_port | +| Amazon Athena | athena.py | 52% | connection_string, pypi_packages | default_port | +| Ascend | ascend.py | 60% | ✓ | default_port, homepage_url, logo | +| Ocient | ocient.py | 61% | ✓ | default_port, homepage_url, logo | +| RisingWave | risingwave.py | 61% | ✓ | default_port, homepage_url, logo | +| Arc | arc.py | 62% | ✓ | default_port, homepage_url, logo | +| Parseable | parseable.py | 62% | ✓ | default_port, homepage_url, logo | +| IBM Db2 | db2.py | 66% | connection_string | default_port | +| Apache Solr | solr.py | 70% | ✓ | default_port, logo | +| Apache Spark SQL | spark.py | 70% | ✓ | default_port, logo | +| CockroachDB | cockroachdb.py | 71% | ✓ | default_port, logo | +| Cloudflare D1 | d1.py | 71% | ✓ | default_port, logo | +| IBM Db2 for i | ibmi.py | 71% | ✓ | default_port, logo | +| Amazon DynamoDB | dynamodb.py | 72% | ✓ | default_port, logo | +| Microsoft SQL Server | mssql.py | 76% | connection_string | ✓ | +| Amazon Redshift | redshift.py | 77% | connection_string | ✓ | +| Apache Hive | hive.py | 80% | ✓ | default_port | +| Apache Impala | impala.py | 80% | ✓ | default_port | +| Apache Kylin | kylin.py | 80% | ✓ | default_port | +| IBM Netezza Performance Server | netezza.py | 80% | ✓ | default_port | +| OceanBase | oceanbase.py | 80% | ✓ | default_port | +| Apache Doris | doris.py | 81% | ✓ | default_port | +| Aurora MySQL (Data API) | aurora.py | 81% | ✓ | default_port | +| Aurora PostgreSQL (Data API) | aurora.py | 81% | ✓ | default_port | +| SQLite | sqlite.py | 81% | ✓ | default_port | +| Teradata | teradata.py | 81% | ✓ | default_port | +| Apache Pinot | pinot.py | 81% | ✓ | default_port | +| Dremio | dremio.py | 81% | ✓ | default_port | +| DuckDB | duckdb.py | 81% | ✓ | default_port | +| Exasol | exasol.py | 81% | ✓ | default_port | +| Firebird | firebird.py | 81% | ✓ | default_port | +| Firebolt | firebolt.py | 81% | ✓ | default_port | +| Google Sheets | gsheets.py | 81% | ✓ | default_port | +| KustoKQL | kusto.py | 81% | ✓ | default_port | +| KustoSQL | kusto.py | 81% | ✓ | default_port | +| Oracle | oracle.py | 81% | ✓ | default_port | +| SAP HANA | hana.py | 81% | ✓ | default_port | +| YDB | ydb.py | 81% | ✓ | default_port | +| ClickHouse | clickhouse.py | 82% | ✓ | default_port | +| SAP Sybase | sybase.py | 82% | ✓ | default_port | +| Databricks Interactive Cluster | databricks.py | 82% | ✓ | default_port | +| Google BigQuery | bigquery.py | 83% | ✓ | default_port | +| Snowflake | snowflake.py | 83% | ✓ | default_port | + +## Complete Specs + +These specs have all required and recommended fields: + +- Apache Druid (92%) +- Couchbase (91%) +- CrateDB (91%) +- Databend (91%) +- Denodo (91%) +- ElasticSearch (OpenDistro SQL) (91%) +- ElasticSearch (SQL API) (91%) +- Greenplum (91%) +- Hologres (91%) +- MariaDB (91%) +- MonetDB (91%) +- MySQL (92%) +- PostgreSQL (94%) +- Presto (92%) +- SingleStore (91%) +- StarRocks (91%) +- TDengine (91%) +- TimescaleDB (92%) +- Trino (92%) +- Vertica (92%) +- YugabyteDB (91%) + +## How to Fix + +Add a `metadata` attribute to your engine spec class: + +```python +from superset.db_engine_specs.base import ( + BaseEngineSpec, DatabaseCategory +) + +class MyEngineSpec(BaseEngineSpec): + engine_name = "My Database" + + metadata = { + "description": "Brief description of the database.", + "category": DatabaseCategory.TRADITIONAL_RDBMS, + "pypi_packages": ["my-driver"], + "connection_string": "mydb://{username}:{password}@{host}:{port}/{database}", + "logo": "mydb.svg", + "homepage_url": "https://mydb.example.com/", + "default_port": 5432, + } +``` + +See `superset/db_engine_specs/README.md` for full documentation. diff --git a/superset/db_engine_specs/README.md b/superset/db_engine_specs/README.md index 5563d138048..d944af21d66 100644 --- a/superset/db_engine_specs/README.md +++ b/superset/db_engine_specs/README.md @@ -556,6 +556,160 @@ Integration with platform features and metadata handling. | YDB | False | False | False | False | | base | False | False | True | False | +## How to Add a New Database + +Adding a new database to Superset involves creating a DB engine spec file with a `metadata` attribute. This metadata is used to generate documentation and provide connection information to users. + +### Quick Start + +1. **Create a new file** in `superset/db_engine_specs/` (e.g., `mydatabase.py`) +2. **Add metadata** with required fields (description, category, pypi_packages, connection_string) +3. **Run the linter** to verify completeness: `python superset/db_engine_specs/lint_metadata.py` +4. **Add a logo** (optional) in `docs/static/img/databases/` + +### Minimal Example + +```python +from superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory + +class MyDatabaseEngineSpec(BaseEngineSpec): + engine = "mydatabase" + engine_name = "My Database" + + metadata = { + # Required fields + "description": "A brief description of the database.", + "category": DatabaseCategory.TRADITIONAL_RDBMS, + "pypi_packages": ["my-database-driver"], + "connection_string": "mydatabase://{username}:{password}@{host}:{port}/{database}", + + # Recommended fields + "logo": "mydatabase.svg", + "homepage_url": "https://mydatabase.example.com/", + "default_port": 5432, + } +``` + +### Full Example with All Fields + +```python +from superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory + +class MyDatabaseEngineSpec(BaseEngineSpec): + engine = "mydatabase" + engine_name = "My Database" + + metadata = { + # Required fields + "description": "A brief description of the database.", + "category": DatabaseCategory.TRADITIONAL_RDBMS, + "pypi_packages": ["my-database-driver"], + "connection_string": "mydatabase://{username}:{password}@{host}:{port}/{database}", + + # Recommended fields + "logo": "mydatabase.svg", # Logo file in docs/static/img/databases/ + "homepage_url": "https://mydatabase.example.com/", + "default_port": 5432, + + # Optional fields + "docs_url": "https://mydatabase.example.com/docs", + "notes": "Any special notes about configuration or usage.", + "install_instructions": "pip install my-database-driver", + "parameters": { + "username": "Database username", + "password": "Database password", + "host": "Hostname or IP address", + "port": "Port number (default: 5432)", + "database": "Database name", + }, + "connection_examples": [ + { + "description": "Local connection", + "connection_string": "mydatabase://user:pass@localhost:5432/mydb", + }, + ], + "authentication_methods": [ + { + "name": "OAuth2", + "description": "Token-based authentication", + }, + ], + "drivers": [ + { + "name": "Default Driver", + "pypi_package": "my-database-driver", + "connection_string": "mydatabase://...", + "is_recommended": True, + }, + ], + "compatible_databases": [ + { + "name": "Compatible DB", + "description": "A database that uses the same protocol", + }, + ], + } +``` + +### Database Categories + +Use constants from `DatabaseCategory` to categorize your database: + +| Category | Description | Examples | +|----------|-------------|----------| +| `CLOUD_AWS` | AWS cloud services | Athena, Redshift, DynamoDB | +| `CLOUD_GCP` | Google Cloud services | BigQuery, Sheets | +| `CLOUD_AZURE` | Azure cloud services | Synapse, Kusto | +| `CLOUD_DATA_WAREHOUSES` | Cloud data warehouses | Snowflake, Databricks | +| `APACHE_PROJECTS` | Apache projects | Druid, Hive, Spark, Pinot | +| `TRADITIONAL_RDBMS` | Traditional databases | PostgreSQL, MySQL, Oracle | +| `ANALYTICAL_DATABASES` | Analytical/OLAP databases | ClickHouse, StarRocks | +| `SEARCH_NOSQL` | Search and NoSQL databases | Elasticsearch, Couchbase | +| `QUERY_ENGINES` | Query engines | Trino, Presto | +| `TIME_SERIES` | Time-series databases | TDengine, TimescaleDB | +| `OTHER` | Other databases | - | + +### Metadata Completeness Linter + +A linter is available to check metadata completeness across all engine specs: + +```bash +# Run the linter to see current status +python superset/db_engine_specs/lint_metadata.py + +# Generate a markdown report +python superset/db_engine_specs/lint_metadata.py --markdown + +# Output to a file +python superset/db_engine_specs/lint_metadata.py --markdown -o METADATA_STATUS.md +``` + +The linter checks for: +- **Required fields**: description, category, pypi_packages, connection_string +- **Recommended fields**: logo, homepage_url, default_port + +See [METADATA_STATUS.md](METADATA_STATUS.md) for the current completeness report. + +### PostgreSQL-Compatible Databases + +If your database is PostgreSQL-compatible, inherit from `PostgresBaseEngineSpec`: + +```python +from superset.db_engine_specs.postgres import PostgresBaseEngineSpec + +class MyPostgresCompatibleEngineSpec(PostgresBaseEngineSpec): + engine = "mydb" + engine_name = "My PostgreSQL-Compatible DB" + + metadata = { + "description": "A PostgreSQL-compatible database.", + "category": DatabaseCategory.TRADITIONAL_RDBMS, + "pypi_packages": ["psycopg2"], # Uses the PostgreSQL driver + "connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}", + "notes": "Uses the PostgreSQL driver. psycopg2 comes bundled with Superset.", + } +``` + ## Database information A DB engine spec has attributes that describe the underlying database engine, so that Superset can know how to build and run queries. For example, some databases don't support subqueries, which are needed for some of the queries produced by Superset for certain charts. When a database doesn't support subqueries the query is run in two-steps, using the results from the first query to build the second query. diff --git a/superset/db_engine_specs/arc.py b/superset/db_engine_specs/arc.py new file mode 100644 index 00000000000..c99402332a4 --- /dev/null +++ b/superset/db_engine_specs/arc.py @@ -0,0 +1,80 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. + +from __future__ import annotations + +from superset.constants import TimeGrain +from superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory + + +class ArcEngineSpec(BaseEngineSpec): + """Engine spec for Arc data platform.""" + + engine = "arc" + engine_name = "Arc" + default_driver = "arrow" + + _time_grain_expressions = { + None: "{col}", + TimeGrain.SECOND: "DATE_TRUNC('second', {col})", + TimeGrain.MINUTE: "DATE_TRUNC('minute', {col})", + TimeGrain.HOUR: "DATE_TRUNC('hour', {col})", + TimeGrain.DAY: "DATE_TRUNC('day', {col})", + TimeGrain.WEEK: "DATE_TRUNC('week', {col})", + TimeGrain.MONTH: "DATE_TRUNC('month', {col})", + TimeGrain.QUARTER: "DATE_TRUNC('quarter', {col})", + TimeGrain.YEAR: "DATE_TRUNC('year', {col})", + } + + metadata = { + "description": "Arc is a data platform with multiple connection options.", + "categories": [DatabaseCategory.OTHER, DatabaseCategory.PROPRIETARY], + "pypi_packages": ["arc-superset-arrow"], + "connection_string": ("arc+arrow://{api_key}@{hostname}:{port}/{database}"), + "parameters": { + "api_key": "Arc API key", + "hostname": "Arc hostname", + "port": "Arc port", + "database": "Database name", + }, + "drivers": [ + { + "name": "Apache Arrow (Recommended)", + "pypi_package": "arc-superset-arrow", + "connection_string": ( + "arc+arrow://{api_key}@{hostname}:{port}/{database}" + ), + "is_recommended": True, + "notes": ( + "Recommended for production. " + "Provides 3-5x better performance using Apache Arrow IPC." + ), + }, + { + "name": "JSON", + "pypi_package": "arc-superset-dialect", + "connection_string": ( + "arc+json://{api_key}@{hostname}:{port}/{database}" + ), + "is_recommended": False, + }, + ], + "notes": ( + "Arc supports multiple databases (schemas) within a single instance. " + "Each Arc database appears as a schema in SQL Lab." + ), + } diff --git a/superset/db_engine_specs/ascend.py b/superset/db_engine_specs/ascend.py index 6d3d7a496e1..b695c4336a7 100644 --- a/superset/db_engine_specs/ascend.py +++ b/superset/db_engine_specs/ascend.py @@ -17,6 +17,7 @@ from sqlalchemy.dialects import registry from superset.constants import TimeGrain +from superset.db_engine_specs.base import DatabaseCategory from superset.db_engine_specs.impala import ImpalaEngineSpec @@ -28,6 +29,24 @@ class AscendEngineSpec(ImpalaEngineSpec): engine_name = "Ascend" + metadata = { + "description": ( + "Ascend.io is a data automation platform for building data pipelines." + ), + "logo": "ascend.webp", + "homepage_url": "https://www.ascend.io/", + "categories": [ + DatabaseCategory.CLOUD_DATA_WAREHOUSES, + DatabaseCategory.ANALYTICAL_DATABASES, + DatabaseCategory.HOSTED_OPEN_SOURCE, + ], + "pypi_packages": ["impyla"], + "connection_string": ( + "ascend://{username}:{password}@{hostname}:{port}/{database}" + "?auth_mechanism=PLAIN;use_ssl=true" + ), + } + _time_grain_expressions = { None: "{col}", TimeGrain.SECOND: "DATE_TRUNC('second', {col})", diff --git a/superset/db_engine_specs/athena.py b/superset/db_engine_specs/athena.py index 002790da0ef..02deb7212b4 100644 --- a/superset/db_engine_specs/athena.py +++ b/superset/db_engine_specs/athena.py @@ -24,7 +24,7 @@ from sqlalchemy import types from sqlalchemy.engine.url import URL from superset.constants import TimeGrain -from superset.db_engine_specs.base import BaseEngineSpec +from superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory from superset.errors import SupersetErrorType SYNTAX_ERROR_REGEX = re.compile( @@ -41,6 +41,64 @@ class AthenaEngineSpec(BaseEngineSpec): use_equality_for_boolean_filters = True supports_dynamic_schema = True + metadata = { + "description": ( + "Amazon Athena is an interactive query service for " + "analyzing data in S3 using SQL." + ), + "logo": "amazon-athena.jpg", + "homepage_url": "https://aws.amazon.com/athena/", + "categories": [ + DatabaseCategory.CLOUD_AWS, + DatabaseCategory.QUERY_ENGINES, + DatabaseCategory.PROPRIETARY, + ], + "pypi_packages": ["pyathena[pandas]"], + "connection_string": ( + "awsathena+rest://{aws_access_key_id}:{aws_secret_access_key}" + "@athena.{region_name}.amazonaws.com/{schema_name}" + "?s3_staging_dir={s3_staging_dir}" + ), + "drivers": [ + { + "name": "PyAthena (REST)", + "pypi_package": "pyathena[pandas]", + "connection_string": ( + "awsathena+rest://{aws_access_key_id}:{aws_secret_access_key}" + "@athena.{region_name}.amazonaws.com/{schema_name}" + "?s3_staging_dir={s3_staging_dir}" + ), + "is_recommended": True, + "notes": ( + "No Java required. URL-encode special characters " + "(e.g., s3:// -> s3%3A//)." + ), + }, + { + "name": "PyAthenaJDBC", + "pypi_package": "PyAthenaJDBC", + "connection_string": ( + "awsathena+jdbc://{aws_access_key_id}:{aws_secret_access_key}" + "@athena.{region_name}.amazonaws.com/{schema_name}" + "?s3_staging_dir={s3_staging_dir}" + ), + "is_recommended": False, + "notes": "Requires Amazon Athena JDBC driver.", + }, + ], + "engine_parameters": [ + { + "name": "IAM Role Assumption", + "description": "Assume a specific IAM role for queries", + "json": {"connect_args": {"role_arn": ""}}, + }, + ], + "notes": ( + "URL-encode special characters in s3_staging_dir " + "(e.g., s3:// becomes s3%3A//)." + ), + } + _time_grain_expressions = { None: "{col}", TimeGrain.SECOND: "date_trunc('second', CAST({col} AS TIMESTAMP))", diff --git a/superset/db_engine_specs/aurora.py b/superset/db_engine_specs/aurora.py index 0baaf1e9b12..6dcbe6e1c0f 100644 --- a/superset/db_engine_specs/aurora.py +++ b/superset/db_engine_specs/aurora.py @@ -19,6 +19,12 @@ from superset.db_engine_specs.postgres import PostgresEngineSpec class AuroraMySQLDataAPI(MySQLEngineSpec): + """Amazon Aurora MySQL via the Data API. + + Note: Documentation is in MySQLEngineSpec's compatible_databases section. + This spec exists for runtime support of the auroradataapi driver. + """ + engine = "mysql" default_driver = "auroradataapi" engine_name = "Aurora MySQL (Data API)" @@ -32,6 +38,12 @@ class AuroraMySQLDataAPI(MySQLEngineSpec): class AuroraPostgresDataAPI(PostgresEngineSpec): + """Amazon Aurora PostgreSQL via the Data API. + + Note: Documentation is in PostgresEngineSpec's compatible_databases section. + This spec exists for runtime support of the auroradataapi driver. + """ + engine = "postgresql" default_driver = "auroradataapi" engine_name = "Aurora PostgreSQL (Data API)" diff --git a/superset/db_engine_specs/base.py b/superset/db_engine_specs/base.py index 6c0cd77478c..396c3805acd 100644 --- a/superset/db_engine_specs/base.py +++ b/superset/db_engine_specs/base.py @@ -187,6 +187,135 @@ class MetricType(TypedDict, total=False): extra: str | None +class DatabaseCategory: + """ + Standard categories for database classification. + Used for organizing databases in documentation and UI. + + Categories are grouped into: + - Cloud providers (where the database runs) + - Database types (what kind of database it is) + - Licensing (open source vs proprietary) + """ + + # Cloud providers + CLOUD_AWS = "Cloud - AWS" + CLOUD_GCP = "Cloud - Google" + CLOUD_AZURE = "Cloud - Azure" + CLOUD_DATA_WAREHOUSES = "Cloud Data Warehouses" + + # Database types + APACHE_PROJECTS = "Apache Projects" + TRADITIONAL_RDBMS = "Traditional RDBMS" + ANALYTICAL_DATABASES = "Analytical Databases" + SEARCH_NOSQL = "Search & NoSQL" + QUERY_ENGINES = "Query Engines" + TIME_SERIES = "Time Series Databases" + OTHER = "Other Databases" + + # Licensing + OPEN_SOURCE = "Open Source" + HOSTED_OPEN_SOURCE = "Hosted Open Source" + PROPRIETARY = "Proprietary" + + +class DriverInfo(TypedDict, total=False): + """Information about a database driver.""" + + name: str + pypi_package: str + connection_string: str + is_recommended: bool + notes: str + docs_url: str + + +class AuthenticationMethod(TypedDict, total=False): + """Information about an authentication method.""" + + name: str + description: str + requirements: str + connection_string: str + engine_parameters: dict[str, Any] + secure_extra: dict[str, Any] + notes: str + + +class ConnectionExample(TypedDict, total=False): + """Example connection string configuration.""" + + description: str + connection_string: str + + +class CompatibleDatabase(TypedDict, total=False): + """Information about a compatible/derived database.""" + + name: str + description: str + logo: str + homepage_url: str + pypi_packages: list[str] + connection_string: str + parameters: dict[str, str] + connection_examples: list[ConnectionExample] + notes: str + docs_url: str + categories: list[str] # Override parent categories (e.g., for HOSTED_OPEN_SOURCE) + + +class DBEngineSpecMetadata(TypedDict, total=False): + """ + Metadata for database engine documentation and UI display. + + This centralizes all documentation-related information for a database + engine, making it easier to add new databases without modifying + multiple files. + """ + + # Basic information + description: str + logo: str # Filename in docs/static/img/databases/ or full URL + homepage_url: str + docs_url: str + sqlalchemy_docs_url: str + categories: list[str] # Use DatabaseCategory constants, supports multiple + + # Connection information + pypi_packages: list[str] + connection_string: str + default_port: int + parameters: dict[str, str] # Parameter name -> description + connection_examples: list[ConnectionExample] + + # Driver options (for databases with multiple drivers) + drivers: list[DriverInfo] + + # Authentication methods + authentication_methods: list[AuthenticationMethod] + + # Engine parameters (JSON configs for advanced options) + engine_parameters: list[dict[str, Any]] + + # Additional information + notes: str + warnings: list[str] + tutorials: list[str] + install_instructions: str + version_requirements: str + + # Related databases (e.g., PostgreSQL-compatible databases) + compatible_databases: list[CompatibleDatabase] + + # Host examples (for databases with platform-specific configs) + host_examples: list[dict[str, str]] + + # Advanced features documentation + ssl_configuration: dict[str, Any] + advanced_features: dict[str, str] + + class BaseEngineSpec: # pylint: disable=too-many-public-methods """Abstract class for database engine specific configurations @@ -203,6 +332,11 @@ class BaseEngineSpec: # pylint: disable=too-many-public-methods engine_name: str | None = None # for user messages, overridden in child classes + # Documentation metadata for this engine spec. Centralizes all documentation + # information so adding a new database only requires modifying one file. + # See DBEngineSpecMetadata TypedDict for available fields. + metadata: DBEngineSpecMetadata = {} + # These attributes map the DB engine spec to one or more SQLAlchemy dialects/drivers; # noqa: E501 # see the ``supports_url`` and ``supports_backend`` methods below. engine = "base" # str as defined in sqlalchemy.engine.engine @@ -583,9 +717,13 @@ class BaseEngineSpec: # pylint: disable=too-many-public-methods "redirect_uri": config["redirect_uri"], "grant_type": "authorization_code", } - if config["request_content_type"] == "data": - return requests.post(uri, data=req_body, timeout=timeout).json() - return requests.post(uri, json=req_body, timeout=timeout).json() + response = ( + requests.post(uri, data=req_body, timeout=timeout) + if config["request_content_type"] == "data" + else requests.post(uri, json=req_body, timeout=timeout) + ) + response.raise_for_status() + return response.json() @classmethod def get_oauth2_fresh_token( @@ -604,9 +742,13 @@ class BaseEngineSpec: # pylint: disable=too-many-public-methods "refresh_token": refresh_token, "grant_type": "refresh_token", } - if config["request_content_type"] == "data": - return requests.post(uri, data=req_body, timeout=timeout).json() - return requests.post(uri, json=req_body, timeout=timeout).json() + response = ( + requests.post(uri, data=req_body, timeout=timeout) + if config["request_content_type"] == "data" + else requests.post(uri, json=req_body, timeout=timeout) + ) + response.raise_for_status() + return response.json() @classmethod def get_allows_alias_in_select( @@ -1153,6 +1295,26 @@ class BaseEngineSpec: # pylint: disable=too-many-public-methods return None + @classmethod + def normalize_table_name_for_upload( + cls, + table_name: str, + schema_name: str | None = None, + ) -> tuple[str, str | None]: + """ + Normalize table and schema names for file upload. + + Some databases (e.g., Redshift) fold unquoted identifiers to lowercase, + which can cause issues when the upload creates a table with one case + but metadata operations use a different case. Override this method + to normalize names according to database-specific rules. + + :param table_name: The table name to normalize + :param schema_name: The schema name to normalize (optional) + :return: Tuple of (normalized_table_name, normalized_schema_name) + """ + return table_name, schema_name + @classmethod def df_to_sql( cls, diff --git a/superset/db_engine_specs/bigquery.py b/superset/db_engine_specs/bigquery.py index b69361c2d11..a269e9ef47d 100644 --- a/superset/db_engine_specs/bigquery.py +++ b/superset/db_engine_specs/bigquery.py @@ -40,7 +40,11 @@ from sqlalchemy.sql.expression import table as sql_table from superset.constants import TimeGrain from superset.databases.schemas import encrypted_field_properties, EncryptedString from superset.databases.utils import make_url_safe -from superset.db_engine_specs.base import BaseEngineSpec, BasicPropertiesType +from superset.db_engine_specs.base import ( + BaseEngineSpec, + BasicPropertiesType, + DatabaseCategory, +) from superset.db_engine_specs.exceptions import SupersetDBAPIConnectionError from superset.errors import SupersetError, SupersetErrorType from superset.exceptions import SupersetException @@ -129,6 +133,53 @@ class BigQueryEngineSpec(BaseEngineSpec): # pylint: disable=too-many-public-met default_driver = "bigquery" sqlalchemy_uri_placeholder = "bigquery://{project_id}" + metadata = { + "description": ( + "Google BigQuery is a serverless, highly scalable data warehouse." + ), + "logo": "google-big-query.svg", + "homepage_url": "https://cloud.google.com/bigquery/", + "categories": [ + DatabaseCategory.CLOUD_GCP, + DatabaseCategory.ANALYTICAL_DATABASES, + DatabaseCategory.PROPRIETARY, + ], + "pypi_packages": ["sqlalchemy-bigquery"], + "connection_string": "bigquery://{project_id}", + "install_instructions": ( + 'echo "sqlalchemy-bigquery" >> ./docker/requirements-local.txt' + ), + "authentication_methods": [ + { + "name": "Service Account JSON", + "description": ( + "Upload service account credentials JSON or paste in Secure Extra" + ), + "secure_extra": { + "credentials_info": { + "type": "service_account", + "project_id": "...", + "private_key_id": "...", + "private_key": "...", + "client_email": "...", + "client_id": "...", + "auth_uri": "...", + "token_uri": "...", + } + }, + }, + ], + "notes": ( + "Create a Service Account via GCP console with access to " + "BigQuery datasets. For CSV/Excel uploads, also install pandas_gbq." + ), + "warnings": [ + "Google BigQuery Python SDK is not compatible with gevent. " + "Use a worker type other than gevent when deploying with gunicorn.", + ], + "docs_url": "https://github.com/googleapis/python-bigquery-sqlalchemy", + } + # BigQuery doesn't maintain context when running multiple statements in the # same cursor, so we need to run all statements at once run_multiple_statements_as_one = True diff --git a/superset/db_engine_specs/clickhouse.py b/superset/db_engine_specs/clickhouse.py index 3f88ffc59e8..4d5caf8c1ff 100644 --- a/superset/db_engine_specs/clickhouse.py +++ b/superset/db_engine_specs/clickhouse.py @@ -36,6 +36,7 @@ from superset.db_engine_specs.base import ( BasicParametersMixin, BasicParametersType, BasicPropertiesType, + DatabaseCategory, ) from superset.db_engine_specs.exceptions import SupersetDBAPIDatabaseError from superset.errors import ErrorLevel, SupersetError, SupersetErrorType @@ -137,14 +138,18 @@ class ClickHouseBaseEngineSpec(BaseEngineSpec): class ClickHouseEngineSpec(ClickHouseBaseEngineSpec): - """Engine spec for clickhouse_sqlalchemy connector""" + """Engine spec for clickhouse_sqlalchemy connector (legacy)""" engine = "clickhouse" - engine_name = "ClickHouse" + engine_name = "ClickHouse (sqlalchemy)" # Internal name for legacy connector _show_functions_column = "name" supports_file_upload = False + # Note: Primary metadata is in ClickHouseConnectEngineSpec which consolidates + # both drivers. This spec exists for backwards compatibility with existing + # connections using the clickhouse-sqlalchemy driver. + @classmethod def get_dbapi_exception_mapping(cls) -> dict[type[Exception], type[Exception]]: return {NewConnectionError: SupersetDBAPIDatabaseError} @@ -255,10 +260,10 @@ except ImportError: # ClickHouse Connect not installed, do nothing class ClickHouseConnectEngineSpec(BasicParametersMixin, ClickHouseEngineSpec): - """Engine spec for clickhouse-connect connector""" + """Engine spec for clickhouse-connect connector (recommended)""" engine = "clickhousedb" - engine_name = "ClickHouse Connect (Superset)" + engine_name = "ClickHouse" default_driver = "connect" _function_names: list[str] = [] @@ -271,6 +276,111 @@ class ClickHouseConnectEngineSpec(BasicParametersMixin, ClickHouseEngineSpec): supports_dynamic_schema = True + metadata = { + "description": ( + "ClickHouse is an open-source column-oriented database for real-time " + "analytics using SQL. It's known for extremely fast query performance " + "on large datasets." + ), + "logo": "clickhouse.png", + "homepage_url": "https://clickhouse.com/", + "categories": [ + DatabaseCategory.ANALYTICAL_DATABASES, + DatabaseCategory.OPEN_SOURCE, + ], + "pypi_packages": ["clickhouse-connect>=0.6.8"], + "connection_string": "clickhousedb://{username}:{password}@{host}:{port}/{database}", + "default_port": 8123, + "drivers": [ + { + "name": "clickhouse-connect (Recommended)", + "pypi_package": "clickhouse-connect>=0.6.8", + "connection_string": ( + "clickhousedb://{username}:{password}@{host}:{port}/{database}" + ), + "is_recommended": True, + "notes": ( + "Official ClickHouse Python driver with native protocol support." + ), + }, + { + "name": "clickhouse-sqlalchemy (Legacy)", + "pypi_package": "clickhouse-sqlalchemy", + "connection_string": ( + "clickhouse://{username}:{password}@{host}:{port}/{database}" + ), + "is_recommended": False, + "notes": ( + "Older driver using HTTP interface. Use clickhouse-connect " + "for new deployments." + ), + }, + ], + "connection_examples": [ + { + "description": "Altinity Cloud", + "connection_string": ( + "clickhousedb://demo:demo@github.demo.trial.altinity.cloud" + "/default?secure=true" + ), + }, + { + "description": "Local (no auth, no SSL)", + "connection_string": "clickhousedb://localhost/default", + }, + ], + "install_instructions": ( + 'echo "clickhouse-connect>=0.6.8" >> ./docker/requirements-local.txt' + ), + "compatible_databases": [ + { + "name": "ClickHouse Cloud", + "description": ( + "ClickHouse Cloud is the official fully-managed cloud service " + "for ClickHouse. It provides automatic scaling, built-in " + "backups, and enterprise security features." + ), + "logo": "clickhouse.png", + "homepage_url": "https://clickhouse.cloud/", + "categories": [ + DatabaseCategory.ANALYTICAL_DATABASES, + DatabaseCategory.CLOUD_DATA_WAREHOUSES, + DatabaseCategory.HOSTED_OPEN_SOURCE, + ], + "pypi_packages": ["clickhouse-connect>=0.6.8"], + "connection_string": ( + "clickhousedb://{username}:{password}@{host}:8443/{database}?secure=true" + ), + "parameters": { + "username": "ClickHouse Cloud username", + "password": "ClickHouse Cloud password", + "host": "Your ClickHouse Cloud hostname", + "database": "Database name (default)", + }, + "docs_url": "https://clickhouse.com/docs/en/cloud", + }, + { + "name": "Altinity.Cloud", + "description": ( + "Altinity.Cloud is a managed ClickHouse service providing " + "Kubernetes-native deployments with enterprise support." + ), + "logo": "altinity.png", + "homepage_url": "https://altinity.cloud/", + "categories": [ + DatabaseCategory.ANALYTICAL_DATABASES, + DatabaseCategory.CLOUD_DATA_WAREHOUSES, + DatabaseCategory.HOSTED_OPEN_SOURCE, + ], + "pypi_packages": ["clickhouse-connect>=0.6.8"], + "connection_string": ( + "clickhousedb://{username}:{password}@{host}/{database}?secure=true" + ), + "docs_url": "https://docs.altinity.com/", + }, + ], + } + @classmethod def get_dbapi_exception_mapping(cls) -> dict[type[Exception], type[Exception]]: return {} diff --git a/superset/db_engine_specs/cockroachdb.py b/superset/db_engine_specs/cockroachdb.py index 4486c569ddd..d200c6e0274 100644 --- a/superset/db_engine_specs/cockroachdb.py +++ b/superset/db_engine_specs/cockroachdb.py @@ -19,6 +19,7 @@ from typing import Any, Optional from sqlalchemy import types +from superset.db_engine_specs.base import DatabaseCategory from superset.db_engine_specs.postgres import PostgresEngineSpec @@ -26,6 +27,22 @@ class CockroachDbEngineSpec(PostgresEngineSpec): engine = "cockroachdb" engine_name = "CockroachDB" + metadata = { + "description": ( + "CockroachDB is a distributed SQL database built for cloud applications." + ), + "logo": "cockroachdb.png", + "homepage_url": "https://www.cockroachlabs.com/", + "categories": [ + DatabaseCategory.TRADITIONAL_RDBMS, + DatabaseCategory.OPEN_SOURCE, + ], + "pypi_packages": ["cockroachdb"], + "connection_string": "cockroachdb://root@{hostname}:{port}/{database}?sslmode=disable", + "default_port": 26257, + "docs_url": "https://github.com/cockroachdb/sqlalchemy-cockroachdb", + } + @classmethod def convert_dttm( cls, target_type: str, dttm: datetime, db_extra: Optional[dict[str, Any]] = None diff --git a/superset/db_engine_specs/couchbase.py b/superset/db_engine_specs/couchbase.py index 6cb8378c9ef..9f4b4b82256 100644 --- a/superset/db_engine_specs/couchbase.py +++ b/superset/db_engine_specs/couchbase.py @@ -32,6 +32,7 @@ from superset.db_engine_specs.base import ( BasicParametersMixin, BasicParametersType as BaseBasicParametersType, BasicPropertiesType as BaseBasicPropertiesType, + DatabaseCategory, ) from superset.errors import ErrorLevel, SupersetError, SupersetErrorType from superset.utils.network import is_hostname_valid, is_port_open @@ -86,6 +87,35 @@ class CouchbaseEngineSpec(BasicParametersMixin, BaseEngineSpec): ) parameters_schema = CouchbaseParametersSchema() + metadata = { + "description": ( + "Couchbase is a distributed NoSQL document database with SQL++ support." + ), + "logo": "couchbase.svg", + "homepage_url": "https://www.couchbase.com/", + "categories": [DatabaseCategory.SEARCH_NOSQL, DatabaseCategory.OPEN_SOURCE], + "pypi_packages": ["couchbase-sqlalchemy"], + "connection_string": "couchbase://{username}:{password}@{host}:{port}?ssl=true", + "default_port": 8091, + "parameters": { + "username": "Couchbase username", + "password": "Couchbase password", + "host": "Couchbase host or connection string for cloud", + "port": "Couchbase port (default 8091)", + "database": "Couchbase database/bucket name", + }, + "drivers": [ + { + "name": "couchbase-sqlalchemy", + "pypi_package": "couchbase-sqlalchemy", + "connection_string": ( + "couchbase://{username}:{password}@{host}:{port}?ssl=true" + ), + "is_recommended": True, + }, + ], + } + _time_grain_expressions = { None: "{col}", TimeGrain.SECOND: "DATE_TRUNC_STR(TOSTRING({col}),'second')", diff --git a/superset/db_engine_specs/crate.py b/superset/db_engine_specs/crate.py index 4952bd5a0d7..f23ccb4dcee 100644 --- a/superset/db_engine_specs/crate.py +++ b/superset/db_engine_specs/crate.py @@ -22,7 +22,7 @@ from typing import Any, TYPE_CHECKING from sqlalchemy import types from superset.constants import TimeGrain -from superset.db_engine_specs.base import BaseEngineSpec +from superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory if TYPE_CHECKING: from superset.connectors.sqla.models import TableColumn @@ -32,6 +32,30 @@ class CrateEngineSpec(BaseEngineSpec): engine = "crate" engine_name = "CrateDB" + metadata = { + "description": ( + "CrateDB is a distributed SQL database for machine data and IoT workloads." + ), + "logo": "cratedb.png", + "homepage_url": "https://crate.io/", + "categories": [DatabaseCategory.TIME_SERIES, DatabaseCategory.OPEN_SOURCE], + "pypi_packages": ["crate", "sqlalchemy-cratedb"], + "connection_string": "crate://{host}:{port}", + "default_port": 4200, + "parameters": { + "host": "CrateDB host", + "port": "CrateDB HTTP port (default 4200)", + }, + "drivers": [ + { + "name": "crate", + "pypi_package": "crate[sqlalchemy]", + "connection_string": "crate://{host}:{port}", + "is_recommended": True, + }, + ], + } + _time_grain_expressions = { None: "{col}", TimeGrain.SECOND: "DATE_TRUNC('second', {col})", diff --git a/superset/db_engine_specs/d1.py b/superset/db_engine_specs/d1.py new file mode 100644 index 00000000000..d49c0db2c62 --- /dev/null +++ b/superset/db_engine_specs/d1.py @@ -0,0 +1,51 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. + +from __future__ import annotations + +from superset.db_engine_specs.base import DatabaseCategory +from superset.db_engine_specs.sqlite import SqliteEngineSpec + + +class CloudflareD1EngineSpec(SqliteEngineSpec): + """Engine spec for Cloudflare D1 serverless SQLite database.""" + + engine = "d1" + engine_name = "Cloudflare D1" + default_driver = "d1" + + metadata = { + "description": "Cloudflare D1 is a serverless SQLite database.", + "logo": "cloudflare.png", + "homepage_url": "https://developers.cloudflare.com/d1/", + "categories": [ + DatabaseCategory.CLOUD_DATA_WAREHOUSES, + DatabaseCategory.TRADITIONAL_RDBMS, + DatabaseCategory.HOSTED_OPEN_SOURCE, + ], + "pypi_packages": ["superset-engine-d1"], + "connection_string": ( + "d1://{cloudflare_account_id}:{cloudflare_api_token}" + "@{cloudflare_d1_database_id}" + ), + "parameters": { + "cloudflare_account_id": "Cloudflare account ID", + "cloudflare_api_token": "Cloudflare API token", + "cloudflare_d1_database_id": "D1 database ID", + }, + "install_instructions": "pip install superset-engine-d1", + } diff --git a/superset/db_engine_specs/databend.py b/superset/db_engine_specs/databend.py index 17cca5280cc..e0e06b2b10a 100644 --- a/superset/db_engine_specs/databend.py +++ b/superset/db_engine_specs/databend.py @@ -35,6 +35,7 @@ from superset.db_engine_specs.base import ( BasicParametersMixin, BasicParametersType, BasicPropertiesType, + DatabaseCategory, ) from superset.db_engine_specs.exceptions import SupersetDBAPIDatabaseError from superset.errors import ErrorLevel, SupersetError, SupersetErrorType @@ -152,15 +153,18 @@ class DatabendBaseEngineSpec(BaseEngineSpec): class DatabendEngineSpec(DatabendBaseEngineSpec): - """Engine spec for databend_sqlalchemy connector""" + """Engine spec for databend_sqlalchemy connector (legacy)""" engine = "databend" - engine_name = "Databend" + engine_name = "Databend (legacy)" # Internal name for legacy connector _function_names: list[str] = [] _show_functions_column = "name" supports_file_upload = False + # Note: Primary metadata is in DatabendConnectEngineSpec which provides + # the native connection UI. This spec exists for backwards compatibility. + @classmethod def get_dbapi_exception_mapping(cls) -> dict[type[Exception], type[Exception]]: return {NewConnectionError: SupersetDBAPIDatabaseError} @@ -208,7 +212,7 @@ class DatabendParametersSchema(Schema): class DatabendConnectEngineSpec(BasicParametersMixin, DatabendEngineSpec): - """Engine spec for databend sqlalchemy connector""" + """Engine spec for databend with native connection UI (recommended)""" engine = "databend" engine_name = "Databend" @@ -222,6 +226,35 @@ class DatabendConnectEngineSpec(BasicParametersMixin, DatabendEngineSpec): parameters_schema = DatabendParametersSchema() encryption_parameters = {"secure": "true"} + # Note: Inherits metadata from DatabendEngineSpec. This spec provides + # the native connection UI experience in Superset. + + metadata = { + "description": ( + "Databend is a modern cloud-native data warehouse with instant elasticity " + "and pay-as-you-go pricing. Built in Rust for high performance." + ), + "logo": "databend.png", + "homepage_url": "https://www.databend.com/", + "categories": [ + DatabaseCategory.CLOUD_DATA_WAREHOUSES, + DatabaseCategory.ANALYTICAL_DATABASES, + DatabaseCategory.PROPRIETARY, + ], + "pypi_packages": ["databend-sqlalchemy"], + "connection_string": ( + "databend://{username}:{password}@{host}:{port}/{database}?secure=true" + ), + "default_port": 443, + "parameters": { + "username": "Database username", + "password": "Database password", + "host": "Databend host", + "port": "Databend port (default 443 for HTTPS)", + "database": "Database name", + }, + } + @classmethod def get_dbapi_exception_mapping(cls) -> dict[type[Exception], type[Exception]]: return {} diff --git a/superset/db_engine_specs/databricks.py b/superset/db_engine_specs/databricks.py index fc3cb8a552f..980c297d106 100644 --- a/superset/db_engine_specs/databricks.py +++ b/superset/db_engine_specs/databricks.py @@ -31,7 +31,11 @@ from sqlalchemy.engine.url import URL from superset.constants import TimeGrain from superset.databases.utils import make_url_safe -from superset.db_engine_specs.base import BaseEngineSpec, BasicParametersMixin +from superset.db_engine_specs.base import ( + BaseEngineSpec, + BasicParametersMixin, + DatabaseCategory, +) from superset.db_engine_specs.hive import HiveEngineSpec from superset.errors import ErrorLevel, SupersetError, SupersetErrorType from superset.utils import json @@ -218,12 +222,18 @@ time_grain_expressions: dict[str | None, str] = { class DatabricksHiveEngineSpec(HiveEngineSpec): + """Databricks engine spec using Hive connector for Interactive Clusters.""" + engine_name = "Databricks Interactive Cluster" engine = "databricks" drivers = {"pyhive": "Hive driver for Interactive Cluster"} default_driver = "pyhive" + # Note: Primary metadata is in DatabricksPythonConnectorEngineSpec which + # consolidates all Databricks connection methods. This spec exists for + # backwards compatibility with Interactive Cluster connections. + _show_functions_column = "function" _time_grain_expressions = time_grain_expressions @@ -244,12 +254,18 @@ class DatabricksBaseEngineSpec(BaseEngineSpec): class DatabricksODBCEngineSpec(DatabricksBaseEngineSpec): + """Databricks engine spec using ODBC driver for SQL Endpoints.""" + engine_name = "Databricks SQL Endpoint" engine = "databricks" drivers = {"pyodbc": "ODBC driver for SQL endpoint"} default_driver = "pyodbc" + # Note: Primary metadata is in DatabricksPythonConnectorEngineSpec which + # consolidates all Databricks connection methods. This spec exists for + # backwards compatibility with ODBC connections to SQL Endpoints. + class DatabricksDynamicBaseEngineSpec(BasicParametersMixin, DatabricksBaseEngineSpec): default_driver = "" @@ -426,6 +442,8 @@ class DatabricksDynamicBaseEngineSpec(BasicParametersMixin, DatabricksBaseEngine class DatabricksNativeEngineSpec(DatabricksDynamicBaseEngineSpec): + """Legacy Databricks connector using databricks-dbapi.""" + engine = "databricks" engine_name = "Databricks (legacy)" drivers = {"connector": "Native all-purpose driver"} @@ -437,6 +455,10 @@ class DatabricksNativeEngineSpec(DatabricksDynamicBaseEngineSpec): sqlalchemy_uri_placeholder = ( "databricks+connector://token:{access_token}@{host}:{port}/{database_name}" ) + + # Note: Primary metadata is in DatabricksPythonConnectorEngineSpec which + # consolidates all Databricks connection methods. This spec exists for + # backwards compatibility with legacy databricks-dbapi connections. context_key_mapping = { **DatabricksDynamicBaseEngineSpec.context_key_mapping, "database": "database", @@ -576,6 +598,78 @@ class DatabricksPythonConnectorEngineSpec(DatabricksDynamicBaseEngineSpec): "&catalog={default_catalog}&schema={default_schema}" ) + metadata = { + "description": ( + "Databricks is a unified analytics platform built on Apache " + "Spark, providing data engineering, data science, and machine " + "learning capabilities in the cloud. Use the Python Connector " + "for SQL warehouses and clusters." + ), + "logo": "databricks.png", + "homepage_url": "https://www.databricks.com/", + "categories": [ + DatabaseCategory.CLOUD_DATA_WAREHOUSES, + DatabaseCategory.ANALYTICAL_DATABASES, + DatabaseCategory.HOSTED_OPEN_SOURCE, + ], + "pypi_packages": ["apache-superset[databricks]"], + "install_instructions": "pip install apache-superset[databricks]", + "connection_string": ( + "databricks://token:{access_token}@{host}:{port}" + "?http_path={http_path}&catalog={catalog}&schema={schema}" + ), + "parameters": { + "access_token": "Personal access token from Settings > User Settings", + "host": "Server hostname from cluster JDBC/ODBC settings", + "port": "Port (default 443)", + "http_path": "HTTP path from cluster JDBC/ODBC settings", + }, + "drivers": [ + { + "name": "Databricks Python Connector (Recommended)", + "pypi_package": "databricks-sql-connector", + "connection_string": ( + "databricks://token:{access_token}@{host}:{port}" + "?http_path={http_path}&catalog={catalog}&schema={schema}" + ), + "is_recommended": True, + "notes": ( + "Official Databricks connector. Best for SQL warehouses " + "and clusters." + ), + }, + { + "name": "Hive Connector (Interactive Clusters)", + "pypi_package": "databricks-dbapi[sqlalchemy]", + "connection_string": ( + "databricks+pyhive://token:{access_token}@{host}:{port}/{database}" + ), + "is_recommended": False, + "notes": ( + "For Interactive Clusters. Requires http_path in engine parameters." + ), + }, + { + "name": "ODBC (SQL Endpoints)", + "pypi_package": "pyodbc", + "connection_string": ( + "databricks+pyodbc://token:{access_token}@{host}:{port}/{database}" + ), + "is_recommended": False, + "notes": "Requires ODBC driver. For serverless SQL warehouses.", + }, + { + "name": "databricks-dbapi (Legacy)", + "pypi_package": "databricks-dbapi[sqlalchemy]", + "connection_string": ( + "databricks+connector://token:{access_token}@{host}:{port}/{database}" + ), + "is_recommended": False, + "notes": "Legacy connector. Use Python Connector for new deployments.", + }, + ], + } + context_key_mapping = { **DatabricksDynamicBaseEngineSpec.context_key_mapping, "default_catalog": "catalog", diff --git a/superset/db_engine_specs/db2.py b/superset/db_engine_specs/db2.py index eec1e2a0f2a..8994113a740 100644 --- a/superset/db_engine_specs/db2.py +++ b/superset/db_engine_specs/db2.py @@ -20,7 +20,7 @@ from typing import Optional, Union from sqlalchemy.engine.reflection import Inspector from superset.constants import TimeGrain -from superset.db_engine_specs.base import BaseEngineSpec +from superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory from superset.models.core import Database from superset.sql.parse import LimitMethod, Table @@ -31,6 +31,61 @@ class Db2EngineSpec(BaseEngineSpec): engine = "db2" engine_aliases = {"ibm_db_sa"} engine_name = "IBM Db2" + + metadata = { + "description": ( + "IBM Db2 is a family of data management products for enterprise workloads, " + "available on-premises, in containers, and across cloud platforms." + ), + "logo": "ibm-db2.svg", + "homepage_url": "https://www.ibm.com/db2", + "categories": [ + DatabaseCategory.TRADITIONAL_RDBMS, + DatabaseCategory.PROPRIETARY, + ], + "pypi_packages": ["ibm_db_sa"], + "connection_string": "db2+ibm_db://{username}:{password}@{hostname}:{port}/{database}", + "default_port": 50000, + "drivers": [ + { + "name": "ibm_db_sa (with LIMIT)", + "connection_string": "db2+ibm_db://{username}:{password}@{hostname}:{port}/{database}", + "is_recommended": True, + }, + { + "name": "ibm_db_sa (without LIMIT syntax)", + "connection_string": "ibm_db_sa://{username}:{password}@{hostname}:{port}/{database}", + "is_recommended": False, + "notes": ( + "Use for older DB2 versions without LIMIT [n] syntax. " + "Recommended for SQL Lab." + ), + }, + ], + "compatible_databases": [ + { + "name": "IBM Db2 for i (AS/400)", + "description": ( + "Db2 for i is a fully integrated database engine on IBM i (AS/400) " + "systems. Uses a different SQLAlchemy driver optimized for IBM i." + ), + "logo": "ibm-db2.svg", + "homepage_url": "https://www.ibm.com/products/db2-for-i", + "pypi_packages": ["sqlalchemy-ibmi"], + "connection_string": "ibmi://{username}:{password}@{host}/{database}", + "parameters": { + "username": "IBM i username", + "password": "IBM i password", + "host": "IBM i system host", + "database": "Library/schema name", + }, + "docs_url": "https://github.com/IBM/sqlalchemy-ibmi", + "categories": [DatabaseCategory.PROPRIETARY], + }, + ], + "docs_url": "https://github.com/ibmdb/python-ibmdbsa", + } + limit_method = LimitMethod.WRAP_SQL force_column_alias_quotes = True max_column_name_length = 30 diff --git a/superset/db_engine_specs/denodo.py b/superset/db_engine_specs/denodo.py index 2de528260f8..3afb82d4e28 100644 --- a/superset/db_engine_specs/denodo.py +++ b/superset/db_engine_specs/denodo.py @@ -20,7 +20,11 @@ from typing import Any, Optional from sqlalchemy.types import Date, DateTime -from superset.db_engine_specs.base import BaseEngineSpec, BasicParametersMixin +from superset.db_engine_specs.base import ( + BaseEngineSpec, + BasicParametersMixin, + DatabaseCategory, +) from superset.errors import SupersetErrorType @@ -60,6 +64,36 @@ class DenodoEngineSpec(BaseEngineSpec, BasicParametersMixin): ) encryption_parameters = {"sslmode": "require"} + metadata = { + "description": ( + "Denodo is a data virtualization platform for logical data management." + ), + "logo": "denodo.png", + "homepage_url": "https://www.denodo.com/", + "categories": [DatabaseCategory.QUERY_ENGINES, DatabaseCategory.PROPRIETARY], + "pypi_packages": ["psycopg2"], + "connection_string": "denodo://{username}:{password}@{host}:{port}/{database}", + "default_port": 9996, + "parameters": { + "username": "Denodo username", + "password": "Denodo password", + "host": "Denodo VDP server hostname", + "port": "ODBC port (default 9996)", + "database": "Virtual database name", + }, + "drivers": [ + { + "name": "psycopg2", + "pypi_package": "psycopg2", + "connection_string": ( + "denodo://{username}:{password}@{host}:{port}/{database}" + ), + "is_recommended": True, + "notes": "Uses PostgreSQL wire protocol.", + }, + ], + } + _time_grain_expressions = { None: "{col}", "PT1M": "TRUNC({col},'MI')", diff --git a/superset/db_engine_specs/doris.py b/superset/db_engine_specs/doris.py index 7db0f667391..ffb451015c7 100644 --- a/superset/db_engine_specs/doris.py +++ b/superset/db_engine_specs/doris.py @@ -26,6 +26,7 @@ from sqlalchemy.engine.reflection import Inspector from sqlalchemy.engine.url import URL from sqlalchemy.sql.type_api import TypeEngine +from superset.db_engine_specs.base import DatabaseCategory from superset.db_engine_specs.mysql import MySQLEngineSpec from superset.errors import SupersetErrorType from superset.models.core import Database @@ -120,6 +121,32 @@ class DorisEngineSpec(MySQLEngineSpec): # while technically supported by Doris, this generates invalid table identifiers supports_cross_catalog_queries = False + metadata = { + "description": ( + "Apache Doris is a high-performance real-time analytical database." + ), + "logo": "doris.png", + "homepage_url": "https://doris.apache.org/", + "categories": [ + DatabaseCategory.APACHE_PROJECTS, + DatabaseCategory.ANALYTICAL_DATABASES, + DatabaseCategory.OPEN_SOURCE, + ], + "pypi_packages": ["pydoris"], + "connection_string": ( + "doris://{username}:{password}@{host}:{port}/{catalog}.{database}" + ), + "default_port": 9030, + "parameters": { + "username": "User name", + "password": "Password", + "host": "Doris FE Host", + "port": "Doris FE port", + "catalog": "Catalog name", + "database": "Database name", + }, + } + column_type_mappings = ( # type: ignore ( re.compile(r"^tinyint", re.IGNORECASE), diff --git a/superset/db_engine_specs/dremio.py b/superset/db_engine_specs/dremio.py index 84dd85198a1..4a71c3cc2d1 100644 --- a/superset/db_engine_specs/dremio.py +++ b/superset/db_engine_specs/dremio.py @@ -24,7 +24,7 @@ from packaging.version import Version from sqlalchemy import types from superset.constants import TimeGrain -from superset.db_engine_specs.base import BaseEngineSpec +from superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory from superset.utils.hashing import hash_from_str if TYPE_CHECKING: @@ -51,6 +51,40 @@ class DremioEngineSpec(BaseEngineSpec): "disableCertificateVerification=true" ) + metadata = { + "description": ( + "Dremio is a data lakehouse platform for fast, self-service analytics." + ), + "logo": "dremio.png", + "homepage_url": "https://www.dremio.com/", + "categories": [DatabaseCategory.QUERY_ENGINES, DatabaseCategory.PROPRIETARY], + "pypi_packages": ["sqlalchemy_dremio"], + "connection_string": ( + "dremio+flight://data.dremio.cloud:443/?Token={token}&UseEncryption=true" + ), + "parameters": { + "token": "Personal Access Token (PAT) or API token", + }, + "drivers": [ + { + "name": "Arrow Flight (Recommended)", + "pypi_package": "sqlalchemy_dremio", + "connection_string": ( + "dremio+flight://data.dremio.cloud:443/" + "?Token={token}&UseEncryption=true" + ), + "is_recommended": True, + }, + { + "name": "ODBC", + "pypi_package": "sqlalchemy_dremio", + "connection_string": "dremio+pyodbc://{token}@{host}:31010/dremio", + "is_recommended": False, + "notes": "Requires Dremio ODBC drivers installed.", + }, + ], + } + _time_grain_expressions = { None: "{col}", TimeGrain.SECOND: "DATE_TRUNC('second', {col})", diff --git a/superset/db_engine_specs/drill.py b/superset/db_engine_specs/drill.py index c4dadfc3b40..de9cdff0f05 100644 --- a/superset/db_engine_specs/drill.py +++ b/superset/db_engine_specs/drill.py @@ -25,7 +25,7 @@ from sqlalchemy import types from sqlalchemy.engine.url import URL from superset.constants import TimeGrain -from superset.db_engine_specs.base import BaseEngineSpec +from superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory from superset.db_engine_specs.exceptions import SupersetDBAPIProgrammingError from superset.utils.hashing import hash_from_str @@ -42,6 +42,61 @@ class DrillEngineSpec(BaseEngineSpec): supports_dynamic_schema = True + metadata = { + "description": ( + "Apache Drill is a schema-free SQL query engine for Hadoop and NoSQL." + ), + "logo": "apache-drill.png", + "homepage_url": "https://drill.apache.org/", + "categories": [ + DatabaseCategory.APACHE_PROJECTS, + DatabaseCategory.QUERY_ENGINES, + DatabaseCategory.OPEN_SOURCE, + ], + "pypi_packages": ["sqlalchemy-drill"], + "connection_string": ( + "drill+sadrill://{username}:{password}@{host}:{port}/" + "{storage_plugin}?use_ssl=True" + ), + "default_port": 8047, + "drivers": [ + { + "name": "SQLAlchemy (REST)", + "pypi_package": "sqlalchemy-drill", + "connection_string": ( + "drill+sadrill://{username}:{password}@{host}:{port}/" + "{storage_plugin}?use_ssl=True" + ), + "is_recommended": True, + }, + { + "name": "JDBC", + "pypi_package": "sqlalchemy-drill", + "connection_string": ( + "drill+jdbc://{username}:{password}@{host}:{port}" + ), + "is_recommended": False, + "notes": "Requires Drill JDBC Driver installation.", + "docs_url": "https://drill.apache.org/docs/using-the-jdbc-driver/", + }, + { + "name": "ODBC", + "pypi_package": "sqlalchemy-drill", + "is_recommended": False, + "notes": "See Apache Drill documentation for ODBC setup.", + "docs_url": ( + "https://drill.apache.org/docs/installing-the-driver-on-linux/" + ), + }, + ], + "connection_examples": [ + { + "description": "Local embedded mode", + "connection_string": "drill+sadrill://localhost:8047/dfs?use_ssl=False", + }, + ], + } + _time_grain_expressions = { None: "{col}", TimeGrain.SECOND: "NEARESTDATE({col}, 'SECOND')", diff --git a/superset/db_engine_specs/druid.py b/superset/db_engine_specs/druid.py index 8692e77c1e9..453231c3910 100644 --- a/superset/db_engine_specs/druid.py +++ b/superset/db_engine_specs/druid.py @@ -25,7 +25,7 @@ from sqlalchemy import types from superset import is_feature_enabled from superset.constants import TimeGrain -from superset.db_engine_specs.base import BaseEngineSpec +from superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory from superset.db_engine_specs.exceptions import SupersetDBAPIConnectionError from superset.exceptions import SupersetException from superset.utils import core as utils, json @@ -46,6 +46,78 @@ class DruidEngineSpec(BaseEngineSpec): allows_joins = is_feature_enabled("DRUID_JOINS") allows_subqueries = True + metadata = { + "description": ( + "Apache Druid is a high performance real-time analytics database." + ), + "logo": "druid.png", + "homepage_url": "https://druid.apache.org/", + "categories": [ + DatabaseCategory.APACHE_PROJECTS, + DatabaseCategory.TIME_SERIES, + DatabaseCategory.OPEN_SOURCE, + ], + "pypi_packages": ["pydruid"], + "connection_string": ( + "druid://{username}:{password}@{host}:{port}/druid/v2/sql" + ), + "default_port": 9088, + "parameters": { + "username": "Database username", + "password": "Database password", + "host": "IP address or URL of the host", + "port": "Default 9088", + }, + "ssl_configuration": { + "custom_certificate": ( + "Add certificate in Root Certificate field. " + "pydruid will automatically use https." + ), + "disable_ssl_verification": { + "engine_params": { + "connect_args": {"scheme": "https", "ssl_verify_cert": False} + } + }, + }, + "advanced_features": { + "aggregations": ( + "Define common aggregations in datasource edit view " + "under List Druid Column tab." + ), + "post_aggregations": ( + "Create metrics with postagg as Metric Type and provide " + "valid JSON post-aggregation definition." + ), + }, + "notes": ( + "A native Druid connector ships with Superset " + "(behind DRUID_IS_ACTIVE flag) but SQLAlchemy connector " + "via pydruid is preferred." + ), + "compatible_databases": [ + { + "name": "Imply", + "description": ( + "Imply is a fully-managed cloud platform and enterprise " + "distribution built on Apache Druid. It provides real-time " + "analytics with enterprise security and support." + ), + "logo": "imply.png", + "homepage_url": "https://imply.io/", + "categories": [ + DatabaseCategory.TIME_SERIES, + DatabaseCategory.CLOUD_DATA_WAREHOUSES, + DatabaseCategory.HOSTED_OPEN_SOURCE, + ], + "pypi_packages": ["pydruid"], + "connection_string": ( + "druid://{username}:{password}@{host}/druid/v2/sql" + ), + "docs_url": "https://docs.imply.io/", + }, + ], + } + _time_grain_expressions = { None: "{col}", TimeGrain.SECOND: "TIME_FLOOR(CAST({col} AS TIMESTAMP), 'PT1S')", diff --git a/superset/db_engine_specs/duckdb.py b/superset/db_engine_specs/duckdb.py index 9bf98426f70..8f19b838d26 100644 --- a/superset/db_engine_specs/duckdb.py +++ b/superset/db_engine_specs/duckdb.py @@ -33,7 +33,7 @@ from sqlalchemy.engine.url import URL from superset.constants import TimeGrain from superset.databases.utils import make_url_safe -from superset.db_engine_specs.base import BaseEngineSpec, LimitMethod +from superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory, LimitMethod from superset.errors import ErrorLevel, SupersetError, SupersetErrorType from superset.utils.core import GenericDataType, get_user_agent, QuerySource @@ -198,6 +198,54 @@ class DuckDBEngineSpec(DuckDBParametersMixin, BaseEngineSpec): sqlalchemy_uri_placeholder = "duckdb:////path/to/duck.db" supports_multivalues_insert = True + metadata = { + "description": ( + "DuckDB is an in-process OLAP database designed for fast " + "analytical queries on local data. Supports CSV, Parquet, JSON, " + "and many other file formats." + ), + "logo": "duckdb.png", + "homepage_url": "https://duckdb.org/", + "categories": [ + DatabaseCategory.ANALYTICAL_DATABASES, + DatabaseCategory.OPEN_SOURCE, + ], + "pypi_packages": ["duckdb-engine"], + "connection_string": "duckdb:////path/to/duck.db", + "drivers": [ + { + "name": "duckdb-engine", + "pypi_package": "duckdb-engine", + "connection_string": "duckdb:////path/to/duck.db", + "is_recommended": True, + }, + ], + "notes": ( + "DuckDB supports both local file and in-memory databases. " + "Use `:memory:` for in-memory database." + ), + "compatible_databases": [ + { + "name": "MotherDuck", + "description": ( + "MotherDuck is a serverless cloud analytics platform " + "built on DuckDB, offering collaborative data sharing " + "and cloud-native scalability." + ), + "logo": "motherduck.png", + "homepage_url": "https://motherduck.com/", + "pypi_packages": ["duckdb", "duckdb-engine"], + "connection_string": "duckdb:///md:{database}?motherduck_token={token}", + "parameters": { + "database": "MotherDuck database name", + "motherduck_token": "Service token from MotherDuck dashboard", + }, + "notes": "Cloud-hosted DuckDB with collaboration features.", + "categories": [DatabaseCategory.HOSTED_OPEN_SOURCE], + }, + ], + } + # DuckDB-specific column type mappings to ensure float/double types are recognized column_type_mappings = ( ( @@ -323,10 +371,44 @@ class DuckDBEngineSpec(DuckDBParametersMixin, BaseEngineSpec): class MotherDuckEngineSpec(DuckDBEngineSpec): + """MotherDuck cloud analytics platform engine spec.""" + engine = "motherduck" engine_name = "MotherDuck" engine_aliases: set[str] = {"duckdb"} + metadata = { + "description": ( + "MotherDuck is a serverless cloud analytics platform " + "built on DuckDB. It combines the simplicity of DuckDB with " + "cloud-scale data sharing and collaboration." + ), + "logo": "motherduck.png", + "homepage_url": "https://motherduck.com/", + "categories": [ + DatabaseCategory.ANALYTICAL_DATABASES, + DatabaseCategory.CLOUD_DATA_WAREHOUSES, + DatabaseCategory.HOSTED_OPEN_SOURCE, + ], + "pypi_packages": ["duckdb", "duckdb-engine"], + "connection_string": "duckdb:///md:{database}?motherduck_token={token}", + "parameters": { + "database": "MotherDuck database name", + "token": "Service token from MotherDuck dashboard", + }, + "docs_url": "https://motherduck.com/docs/getting-started/", + "drivers": [ + { + "name": "duckdb-engine", + "pypi_package": "duckdb-engine", + "connection_string": ( + "duckdb:///md:{database}?motherduck_token={token}" + ), + "is_recommended": True, + }, + ], + } + supports_catalog = True supports_dynamic_catalog = True diff --git a/superset/db_engine_specs/dynamodb.py b/superset/db_engine_specs/dynamodb.py index 0a29f8d4ae9..e2e035ff533 100644 --- a/superset/db_engine_specs/dynamodb.py +++ b/superset/db_engine_specs/dynamodb.py @@ -20,13 +20,38 @@ from typing import Any, Optional from sqlalchemy import types from superset.constants import TimeGrain -from superset.db_engine_specs.base import BaseEngineSpec +from superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory class DynamoDBEngineSpec(BaseEngineSpec): engine = "dynamodb" engine_name = "Amazon DynamoDB" + metadata = { + "description": ( + "Amazon DynamoDB is a serverless NoSQL database with SQL via PartiQL." + ), + "logo": "aws.png", + "homepage_url": "https://aws.amazon.com/dynamodb/", + "categories": [ + DatabaseCategory.CLOUD_AWS, + DatabaseCategory.SEARCH_NOSQL, + DatabaseCategory.PROPRIETARY, + ], + "pypi_packages": ["pydynamodb"], + "connection_string": ( + "dynamodb://{aws_access_key_id}:{aws_secret_access_key}" + "@dynamodb.{region}.amazonaws.com:443?connector=superset" + ), + "parameters": { + "aws_access_key_id": "AWS access key ID", + "aws_secret_access_key": "AWS secret access key", + "region": "AWS region (e.g., us-east-1)", + }, + "notes": "Uses PartiQL for SQL queries. Requires connector=superset parameter.", + "docs_url": "https://github.com/passren/PyDynamoDB", + } + _time_grain_expressions = { None: "{col}", TimeGrain.SECOND: "DATETIME(STRFTIME('%Y-%m-%dT%H:%M:%S', {col}))", diff --git a/superset/db_engine_specs/elasticsearch.py b/superset/db_engine_specs/elasticsearch.py index 163bc640a6a..447605055ea 100644 --- a/superset/db_engine_specs/elasticsearch.py +++ b/superset/db_engine_specs/elasticsearch.py @@ -22,7 +22,7 @@ from packaging.version import Version from sqlalchemy import types from superset.constants import TimeGrain -from superset.db_engine_specs.base import BaseEngineSpec +from superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory from superset.db_engine_specs.exceptions import ( SupersetDBAPIDatabaseError, SupersetDBAPIOperationalError, @@ -34,12 +34,91 @@ logger = logging.getLogger() class ElasticSearchEngineSpec(BaseEngineSpec): # pylint: disable=abstract-method engine = "elasticsearch" - engine_name = "ElasticSearch (SQL API)" + engine_name = "Elasticsearch" time_groupby_inline = True allows_joins = False allows_subqueries = True allows_sql_comments = False + metadata = { + "description": ( + "Elasticsearch is a distributed search and analytics engine. " + "Query data using Elasticsearch SQL or OpenSearch SQL syntax." + ), + "logo": "elasticsearch.png", + "homepage_url": "https://www.elastic.co/elasticsearch/", + "categories": [DatabaseCategory.SEARCH_NOSQL, DatabaseCategory.OPEN_SOURCE], + "pypi_packages": ["elasticsearch-dbapi"], + "connection_string": "elasticsearch+https://{user}:{password}@{host}:9243/", + "default_port": 9243, + "parameters": { + "user": "Elasticsearch username", + "password": "Elasticsearch password", + "host": "Elasticsearch host", + }, + "drivers": [ + { + "name": "Elasticsearch SQL API (Recommended)", + "pypi_package": "elasticsearch-dbapi", + "connection_string": "elasticsearch+https://{user}:{password}@{host}:9243/", + "is_recommended": True, + "notes": ( + "For Elastic Cloud and self-hosted Elasticsearch with SQL enabled." + ), + }, + { + "name": "OpenDistro / OpenSearch SQL", + "pypi_package": "elasticsearch-dbapi", + "connection_string": "odelasticsearch+https://{user}:{password}@{host}:9200/", + "is_recommended": False, + "notes": "For OpenDistro Elasticsearch or Amazon OpenSearch Service.", + }, + ], + "compatible_databases": [ + { + "name": "Elastic Cloud", + "description": ( + "Elastic Cloud is the official managed Elasticsearch service " + "from Elastic. It includes Elasticsearch, Kibana, and " + "enterprise features with automatic scaling." + ), + "logo": "elasticsearch.png", + "homepage_url": "https://www.elastic.co/cloud/", + "categories": [ + DatabaseCategory.SEARCH_NOSQL, + DatabaseCategory.HOSTED_OPEN_SOURCE, + ], + "pypi_packages": ["elasticsearch-dbapi"], + "connection_string": ( + "elasticsearch+https://{user}:{password}@{deployment}.{region}" + ".cloud.es.io:9243/" + ), + "docs_url": "https://www.elastic.co/guide/en/cloud/current/", + }, + { + "name": "Amazon OpenSearch Service", + "description": ( + "Amazon OpenSearch Service (successor to Amazon Elasticsearch " + "Service) is a managed search and analytics service on AWS." + ), + "logo": "elasticsearch.png", + "homepage_url": "https://aws.amazon.com/opensearch-service/", + "categories": [ + DatabaseCategory.SEARCH_NOSQL, + DatabaseCategory.CLOUD_AWS, + DatabaseCategory.HOSTED_OPEN_SOURCE, + ], + "pypi_packages": ["elasticsearch-dbapi"], + "connection_string": ( + "odelasticsearch+https://{user}:{password}@{host}:443/" + ), + "docs_url": ( + "https://docs.aws.amazon.com/opensearch-service/latest/developerguide/" + ), + }, + ], + } + _date_trunc_functions = { "DATETIME": "DATE_TRUNC", } @@ -101,6 +180,12 @@ class ElasticSearchEngineSpec(BaseEngineSpec): # pylint: disable=abstract-metho class OpenDistroEngineSpec(BaseEngineSpec): # pylint: disable=abstract-method + """OpenDistro/OpenSearch SQL engine spec. + + Note: Documentation is consolidated in ElasticSearchEngineSpec. + This spec exists for runtime support of the odelasticsearch driver. + """ + time_groupby_inline = True allows_joins = False allows_subqueries = True @@ -117,7 +202,7 @@ class OpenDistroEngineSpec(BaseEngineSpec): # pylint: disable=abstract-method } engine = "odelasticsearch" - engine_name = "ElasticSearch (OpenDistro SQL)" + engine_name = "OpenSearch (OpenDistro)" @classmethod def convert_dttm( diff --git a/superset/db_engine_specs/exasol.py b/superset/db_engine_specs/exasol.py index e5f8c011d16..bd83a5d34f0 100644 --- a/superset/db_engine_specs/exasol.py +++ b/superset/db_engine_specs/exasol.py @@ -17,7 +17,7 @@ from typing import Any, Optional from superset.constants import TimeGrain -from superset.db_engine_specs.base import BaseEngineSpec +from superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory class ExasolEngineSpec(BaseEngineSpec): # pylint: disable=abstract-method @@ -27,6 +27,51 @@ class ExasolEngineSpec(BaseEngineSpec): # pylint: disable=abstract-method engine_name = "Exasol" max_column_name_length = 128 + metadata = { + "description": ( + "Exasol is a high-performance, in-memory, MPP analytical database." + ), + "logo": "exasol.png", + "homepage_url": "https://www.exasol.com/", + "categories": [ + DatabaseCategory.ANALYTICAL_DATABASES, + DatabaseCategory.PROPRIETARY, + ], + "pypi_packages": ["sqlalchemy-exasol"], + "connection_string": "exa+pyodbc://{username}:{password}@{dsn}", + "default_port": 8563, + "parameters": { + "username": "Database username", + "password": "Database password", + "dsn": "DSN name configured in odbc.ini", + }, + "drivers": [ + { + "name": "pyodbc", + "pypi_package": "sqlalchemy-exasol", + "connection_string": "exa+pyodbc://{username}:{password}@{dsn}", + "is_recommended": True, + "notes": "Requires ODBC driver and DSN configuration.", + }, + { + "name": "turbodbc", + "pypi_package": "sqlalchemy-exasol[turbodbc]", + "connection_string": "exa+turbodbc://{username}:{password}@{dsn}", + "is_recommended": False, + "notes": "Faster but requires additional dependencies.", + }, + { + "name": "websocket", + "pypi_package": "sqlalchemy-exasol[websocket]", + "connection_string": ( + "exa+websocket://{username}:{password}@{host}:{port}/{schema}" + ), + "is_recommended": False, + "notes": "Pure Python, no ODBC required.", + }, + ], + } + # Exasol's DATE_TRUNC function is PostgresSQL compatible _time_grain_expressions = { None: "{col}", diff --git a/superset/db_engine_specs/firebird.py b/superset/db_engine_specs/firebird.py index d8222d81d4f..e965fd86f21 100644 --- a/superset/db_engine_specs/firebird.py +++ b/superset/db_engine_specs/firebird.py @@ -20,7 +20,7 @@ from typing import Any, Optional from sqlalchemy import types from superset.constants import TimeGrain -from superset.db_engine_specs.base import BaseEngineSpec +from superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory from superset.sql.parse import LimitMethod @@ -30,6 +30,26 @@ class FirebirdEngineSpec(BaseEngineSpec): engine = "firebird" engine_name = "Firebird" + metadata = { + "description": "Firebird is an open-source relational database.", + "logo": "firebird.png", + "homepage_url": "https://firebirdsql.org/", + "categories": [ + DatabaseCategory.TRADITIONAL_RDBMS, + DatabaseCategory.OPEN_SOURCE, + ], + "pypi_packages": ["sqlalchemy-firebird"], + "version_requirements": "sqlalchemy-firebird>=0.7.0,<0.8", + "connection_string": "firebird+fdb://{username}:{password}@{host}:{port}//{path_to_db_file}", + "default_port": 3050, + "connection_examples": [ + { + "description": "Local database", + "connection_string": "firebird+fdb://SYSDBA:masterkey@192.168.86.38:3050//Library/Frameworks/Firebird.framework/Versions/A/Resources/examples/empbuild/employee.fdb", + }, + ], + } + # Firebird uses FIRST to limit: `SELECT FIRST 10 * FROM table` limit_method = LimitMethod.FETCH_MANY diff --git a/superset/db_engine_specs/firebolt.py b/superset/db_engine_specs/firebolt.py index 13ab727ab09..f418b6902f0 100644 --- a/superset/db_engine_specs/firebolt.py +++ b/superset/db_engine_specs/firebolt.py @@ -20,7 +20,7 @@ from typing import Any, Optional from sqlalchemy import types from superset.constants import TimeGrain -from superset.db_engine_specs.base import BaseEngineSpec +from superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory class FireboltEngineSpec(BaseEngineSpec): @@ -30,6 +30,43 @@ class FireboltEngineSpec(BaseEngineSpec): engine_name = "Firebolt" default_driver = "firebolt" + metadata = { + "description": ( + "Firebolt is a cloud data warehouse designed for " + "high-performance analytics." + ), + "logo": "firebolt.png", + "homepage_url": "https://www.firebolt.io/", + "categories": [ + DatabaseCategory.CLOUD_DATA_WAREHOUSES, + DatabaseCategory.ANALYTICAL_DATABASES, + DatabaseCategory.PROPRIETARY, + ], + "pypi_packages": ["firebolt-sqlalchemy"], + "connection_string": ( + "firebolt://{client_id}:{client_secret}@{database}/{engine_name}" + "?account_name={account_name}" + ), + "parameters": { + "client_id": "Service account client ID", + "client_secret": "Service account client secret", + "database": "Database name", + "engine_name": "Engine name", + "account_name": "Account name", + }, + "drivers": [ + { + "name": "firebolt-sqlalchemy", + "pypi_package": "firebolt-sqlalchemy", + "connection_string": ( + "firebolt://{client_id}:{client_secret}@{database}/{engine_name}" + "?account_name={account_name}" + ), + "is_recommended": True, + }, + ], + } + _time_grain_expressions = { None: "{col}", TimeGrain.SECOND: "date_trunc('second', CAST({col} AS TIMESTAMP))", diff --git a/superset/db_engine_specs/greenplum.py b/superset/db_engine_specs/greenplum.py new file mode 100644 index 00000000000..06c72bc6c38 --- /dev/null +++ b/superset/db_engine_specs/greenplum.py @@ -0,0 +1,55 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. + +from superset.db_engine_specs.base import DatabaseCategory +from superset.db_engine_specs.postgres import PostgresEngineSpec + + +class GreenplumEngineSpec(PostgresEngineSpec): + """Engine spec for VMware Greenplum (formerly Pivotal Greenplum) + + Greenplum is a massively parallel processing (MPP) database built on PostgreSQL. + It inherits PostgreSQL's SQL syntax and most features. + """ + + engine = "greenplum" + engine_name = "Greenplum" + default_driver = "psycopg2" + + metadata = { + "description": ( + "VMware Greenplum is a massively parallel processing (MPP) " + "database built on PostgreSQL." + ), + "logo": "greenplum.png", + "homepage_url": "https://greenplum.org/", + "categories": [ + DatabaseCategory.TRADITIONAL_RDBMS, + DatabaseCategory.OPEN_SOURCE, + ], + "pypi_packages": ["sqlalchemy-greenplum", "psycopg2"], + "connection_string": "greenplum://{username}:{password}@{host}:{port}/{database}", + "default_port": 5432, + "parameters": { + "username": "Database username", + "password": "Database password", + "host": "Greenplum coordinator host", + "port": "Default 5432", + "database": "Database name", + }, + "docs_url": "https://docs.vmware.com/en/VMware-Greenplum/", + } diff --git a/superset/db_engine_specs/gsheets.py b/superset/db_engine_specs/gsheets.py index 30da234fd2c..a36e95b92da 100644 --- a/superset/db_engine_specs/gsheets.py +++ b/superset/db_engine_specs/gsheets.py @@ -37,6 +37,7 @@ from sqlalchemy.engine.url import URL from superset import db, security_manager from superset.databases.schemas import encrypted_field_properties, EncryptedString +from superset.db_engine_specs.base import DatabaseCategory from superset.db_engine_specs.shillelagh import ShillelaghEngineSpec from superset.errors import ErrorLevel, SupersetError, SupersetErrorType from superset.exceptions import SupersetException @@ -104,6 +105,22 @@ class GSheetsEngineSpec(ShillelaghEngineSpec): default_driver = "apsw" sqlalchemy_uri_placeholder = "gsheets://" + metadata = { + "description": ( + "Google Sheets allows querying spreadsheets as SQL tables via shillelagh." + ), + "logo": "google-sheets.svg", + "homepage_url": "https://www.google.com/sheets/about/", + "categories": [DatabaseCategory.CLOUD_GCP, DatabaseCategory.HOSTED_OPEN_SOURCE], + "pypi_packages": ["shillelagh[gsheetsapi]"], + "install_instructions": 'pip install "apache-superset[gsheets]"', + "connection_string": "gsheets://", + "notes": ( + "Requires Google service account credentials or OAuth2 authentication. " + "See docs for setup instructions." + ), + } + # when editing the database, mask this field in `encrypted_extra` # pylint: disable=invalid-name encrypted_extra_sensitive_fields = {"$.service_account_info.private_key"} diff --git a/superset/db_engine_specs/hana.py b/superset/db_engine_specs/hana.py index 3ae70349eca..d0d36dcb6df 100644 --- a/superset/db_engine_specs/hana.py +++ b/superset/db_engine_specs/hana.py @@ -20,6 +20,7 @@ from typing import Any, Optional from sqlalchemy import types from superset.constants import TimeGrain +from superset.db_engine_specs.base import DatabaseCategory from superset.db_engine_specs.postgres import PostgresBaseEngineSpec from superset.sql.parse import LimitMethod @@ -27,6 +28,23 @@ from superset.sql.parse import LimitMethod class HanaEngineSpec(PostgresBaseEngineSpec): engine = "hana" engine_name = "SAP HANA" + + metadata = { + "description": ( + "SAP HANA is an in-memory relational database and application platform." + ), + "logo": "sap-hana.png", + "homepage_url": "https://www.sap.com/products/technology-platform/hana.html", + "categories": [ + DatabaseCategory.TRADITIONAL_RDBMS, + DatabaseCategory.PROPRIETARY, + ], + "pypi_packages": ["hdbcli", "sqlalchemy-hana"], + "install_instructions": "pip install apache_superset[hana]", + "connection_string": "hana://{username}:{password}@{host}:{port}", + "default_port": 30015, + "docs_url": "https://github.com/SAP/sqlalchemy-hana", + } limit_method = LimitMethod.WRAP_SQL force_column_alias_quotes = True max_column_name_length = 30 diff --git a/superset/db_engine_specs/hive.py b/superset/db_engine_specs/hive.py index e33438338d2..e63747ace16 100644 --- a/superset/db_engine_specs/hive.py +++ b/superset/db_engine_specs/hive.py @@ -39,7 +39,7 @@ from sqlalchemy.sql.expression import ColumnClause, Select from superset import db from superset.common.db_query_status import QueryStatus from superset.constants import TimeGrain -from superset.db_engine_specs.base import BaseEngineSpec +from superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory from superset.db_engine_specs.presto import PrestoEngineSpec from superset.exceptions import SupersetException from superset.extensions import cache_manager @@ -97,6 +97,22 @@ class HiveEngineSpec(PrestoEngineSpec): supports_dynamic_schema = True supports_cross_catalog_queries = False + metadata = { + "description": ( + "Apache Hive is a data warehouse infrastructure built on Hadoop." + ), + "logo": "apache-hive.svg", + "homepage_url": "https://hive.apache.org/", + "categories": [ + DatabaseCategory.APACHE_PROJECTS, + DatabaseCategory.QUERY_ENGINES, + DatabaseCategory.OPEN_SOURCE, + ], + "pypi_packages": ["pyhive"], + "connection_string": "hive://hive@{hostname}:{port}/{database}", + "default_port": 10000, + } + # When running `SHOW FUNCTIONS`, what is the name of the column with the # function names? _show_functions_column = "tab_name" diff --git a/superset/db_engine_specs/hologres.py b/superset/db_engine_specs/hologres.py new file mode 100644 index 00000000000..ce4cb3c905b --- /dev/null +++ b/superset/db_engine_specs/hologres.py @@ -0,0 +1,60 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. + +from __future__ import annotations + +from superset.db_engine_specs.base import DatabaseCategory +from superset.db_engine_specs.postgres import PostgresBaseEngineSpec + + +class HologresEngineSpec(PostgresBaseEngineSpec): + """ + Engine spec for Alibaba Cloud Hologres. + + Hologres is fully compatible with PostgreSQL 11. + """ + + engine = "hologres" + engine_name = "Hologres" + default_driver = "psycopg2" + + metadata = { + "description": ( + "Alibaba Cloud Hologres is a real-time interactive analytics service, " + "fully compatible with PostgreSQL 11." + ), + "logo": "hologres.png", + "homepage_url": "https://www.alibabacloud.com/product/hologres", + "categories": [ + DatabaseCategory.CLOUD_DATA_WAREHOUSES, + DatabaseCategory.ANALYTICAL_DATABASES, + DatabaseCategory.PROPRIETARY, + ], + "pypi_packages": ["psycopg2"], + "connection_string": ( + "postgresql+psycopg2://{username}:{password}@{host}:{port}/{database}" + ), + "parameters": { + "username": "AccessKey ID of your Alibaba Cloud account", + "password": "AccessKey secret of your Alibaba Cloud account", + "host": "Public endpoint of the Hologres instance", + "port": "Port number of the Hologres instance", + "database": "Name of the Hologres database", + }, + "default_port": 80, + "notes": "Uses the PostgreSQL driver. psycopg2 comes bundled with Superset.", + } diff --git a/superset/db_engine_specs/ibmi.py b/superset/db_engine_specs/ibmi.py index cac66ebc277..481c714d793 100644 --- a/superset/db_engine_specs/ibmi.py +++ b/superset/db_engine_specs/ibmi.py @@ -18,6 +18,12 @@ from .db2 import Db2EngineSpec class IBMiEngineSpec(Db2EngineSpec): + """IBM Db2 for i (AS/400) engine spec. + + Note: Documentation is in Db2EngineSpec's compatible_databases section. + This spec exists for runtime support of the ibmi driver. + """ + engine = "ibmi" engine_name = "IBM Db2 for i" max_column_name_length = 128 diff --git a/superset/db_engine_specs/impala.py b/superset/db_engine_specs/impala.py index 4438f38e8c3..5230e7cc133 100644 --- a/superset/db_engine_specs/impala.py +++ b/superset/db_engine_specs/impala.py @@ -30,7 +30,7 @@ from sqlalchemy.engine.reflection import Inspector from superset import db from superset.constants import QUERY_EARLY_CANCEL_KEY, TimeGrain -from superset.db_engine_specs.base import BaseEngineSpec +from superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory from superset.models.sql_lab import Query if TYPE_CHECKING: @@ -47,6 +47,23 @@ class ImpalaEngineSpec(BaseEngineSpec): engine = "impala" engine_name = "Apache Impala" + metadata = { + "description": ( + "Apache Impala is an open-source massively parallel " + "processing SQL query engine." + ), + "logo": "apache-impala.png", + "homepage_url": "https://impala.apache.org/", + "categories": [ + DatabaseCategory.APACHE_PROJECTS, + DatabaseCategory.QUERY_ENGINES, + DatabaseCategory.OPEN_SOURCE, + ], + "pypi_packages": ["impyla"], + "connection_string": "impala://{hostname}:{port}/{database}", + "default_port": 21050, + } + _time_grain_expressions = { None: "{col}", TimeGrain.MINUTE: "TRUNC({col}, 'MI')", diff --git a/superset/db_engine_specs/kusto.py b/superset/db_engine_specs/kusto.py index 9181b078592..7177cd13fb2 100644 --- a/superset/db_engine_specs/kusto.py +++ b/superset/db_engine_specs/kusto.py @@ -22,7 +22,7 @@ from sqlalchemy import types from sqlalchemy.dialects.mssql.base import SMALLDATETIME from superset.constants import TimeGrain -from superset.db_engine_specs.base import BaseEngineSpec +from superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory from superset.db_engine_specs.exceptions import ( SupersetDBAPIDatabaseError, SupersetDBAPIOperationalError, @@ -35,12 +35,66 @@ from superset.utils.core import GenericDataType class KustoSqlEngineSpec(BaseEngineSpec): # pylint: disable=abstract-method limit_method = LimitMethod.WRAP_SQL engine = "kustosql" - engine_name = "KustoSQL" + engine_name = "Azure Data Explorer" time_groupby_inline = True allows_joins = True allows_subqueries = True allows_sql_comments = False + metadata = { + "description": ( + "Azure Data Explorer (Kusto) is a fast, fully managed data analytics " + "service from Microsoft Azure. Query data using SQL or native KQL syntax." + ), + "logo": "kusto.png", + "homepage_url": "https://azure.microsoft.com/en-us/products/data-explorer/", + "categories": [ + DatabaseCategory.CLOUD_AZURE, + DatabaseCategory.ANALYTICAL_DATABASES, + DatabaseCategory.PROPRIETARY, + ], + "pypi_packages": ["sqlalchemy-kusto"], + "connection_string": ( + "kustosql+https://{cluster}.kusto.windows.net/{database}" + "?msi=False&azure_ad_client_id={client_id}" + "&azure_ad_client_secret={client_secret}" + "&azure_ad_tenant_id={tenant_id}" + ), + "parameters": { + "cluster": "Azure Data Explorer cluster name", + "database": "Database name", + "client_id": "Azure AD application (client) ID", + "client_secret": "Azure AD application secret", + "tenant_id": "Azure AD tenant ID", + }, + "drivers": [ + { + "name": "SQL Interface (Recommended)", + "pypi_package": "sqlalchemy-kusto", + "connection_string": ( + "kustosql+https://{cluster}.kusto.windows.net/{database}" + "?msi=False&azure_ad_client_id={client_id}" + "&azure_ad_client_secret={client_secret}" + "&azure_ad_tenant_id={tenant_id}" + ), + "is_recommended": True, + "notes": "Use familiar SQL syntax to query Azure Data Explorer.", + }, + { + "name": "KQL (Kusto Query Language)", + "pypi_package": "sqlalchemy-kusto", + "connection_string": ( + "kustokql+https://{cluster}.kusto.windows.net/{database}" + "?msi=False&azure_ad_client_id={client_id}" + "&azure_ad_client_secret={client_secret}" + "&azure_ad_tenant_id={tenant_id}" + ), + "is_recommended": False, + "notes": "Use native Kusto Query Language for advanced analytics.", + }, + ], + } + _time_grain_expressions = { None: "{col}", TimeGrain.SECOND: "DATEADD(second, \ @@ -106,8 +160,14 @@ class KustoSqlEngineSpec(BaseEngineSpec): # pylint: disable=abstract-method class KustoKqlEngineSpec(BaseEngineSpec): # pylint: disable=abstract-method + """Azure Data Explorer engine spec using native KQL query language. + + Note: Documentation is consolidated in KustoSqlEngineSpec (Azure Data Explorer). + This spec exists for runtime support of the kustokql driver. + """ + engine = "kustokql" - engine_name = "KustoKQL" + engine_name = "Azure Data Explorer (KQL)" time_groupby_inline = True allows_joins = True allows_subqueries = True diff --git a/superset/db_engine_specs/kylin.py b/superset/db_engine_specs/kylin.py index 42f3aeab1ac..4a05e08ad8e 100644 --- a/superset/db_engine_specs/kylin.py +++ b/superset/db_engine_specs/kylin.py @@ -20,7 +20,7 @@ from typing import Any, Optional from sqlalchemy import types from superset.constants import TimeGrain -from superset.db_engine_specs.base import BaseEngineSpec +from superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory class KylinEngineSpec(BaseEngineSpec): # pylint: disable=abstract-method @@ -29,6 +29,23 @@ class KylinEngineSpec(BaseEngineSpec): # pylint: disable=abstract-method engine = "kylin" engine_name = "Apache Kylin" + metadata = { + "description": "Apache Kylin is an open-source OLAP engine for big data.", + "logo": "apache-kylin.png", + "homepage_url": "https://kylin.apache.org/", + "categories": [ + DatabaseCategory.APACHE_PROJECTS, + DatabaseCategory.ANALYTICAL_DATABASES, + DatabaseCategory.OPEN_SOURCE, + ], + "pypi_packages": ["kylinpy"], + "connection_string": ( + "kylin://{username}:{password}@{hostname}:{port}/{project}" + "?{param1}={value1}&{param2}={value2}" + ), + "default_port": 7070, + } + _time_grain_expressions = { None: "{col}", TimeGrain.SECOND: "CAST(FLOOR(CAST({col} AS TIMESTAMP) TO SECOND) AS TIMESTAMP)", # noqa: E501 diff --git a/superset/db_engine_specs/lib.py b/superset/db_engine_specs/lib.py index 52d48e449e9..4fd7ccaec56 100644 --- a/superset/db_engine_specs/lib.py +++ b/superset/db_engine_specs/lib.py @@ -17,8 +17,11 @@ from __future__ import annotations +import os from typing import Any +import yaml + from superset.constants import TimeGrain from superset.db_engine_specs import load_engine_specs from superset.db_engine_specs.base import BaseEngineSpec @@ -662,11 +665,169 @@ def generate_table() -> list[list[Any]]: return rows +def infer_category(name: str) -> str: + """ + Infer database category from name for unmigrated specs. + + This is used as a fallback when a spec doesn't have category in metadata. + Once all specs are migrated to use metadata.category, this can be removed. + """ + from superset.db_engine_specs.base import DatabaseCategory + + name_lower = name.lower() + + if "aws" in name_lower or "amazon" in name_lower: + return DatabaseCategory.CLOUD_AWS + if "google" in name_lower or "bigquery" in name_lower: + return DatabaseCategory.CLOUD_GCP + if "azure" in name_lower or "microsoft" in name_lower: + return DatabaseCategory.CLOUD_AZURE + if "snowflake" in name_lower or "databricks" in name_lower: + return DatabaseCategory.CLOUD_DATA_WAREHOUSES + if ( + "apache" in name_lower + or "druid" in name_lower + or "hive" in name_lower + or "spark" in name_lower + ): + return DatabaseCategory.APACHE_PROJECTS + if ( + "postgres" in name_lower + or "mysql" in name_lower + or "sqlite" in name_lower + or "mariadb" in name_lower + ): + return DatabaseCategory.TRADITIONAL_RDBMS + if ( + "clickhouse" in name_lower + or "vertica" in name_lower + or "starrocks" in name_lower + ): + return DatabaseCategory.ANALYTICAL_DATABASES + if "elastic" in name_lower or "solr" in name_lower or "couchbase" in name_lower: + return DatabaseCategory.SEARCH_NOSQL + if "trino" in name_lower or "presto" in name_lower: + return DatabaseCategory.QUERY_ENGINES + + return DatabaseCategory.OTHER + + +def get_documentation_metadata(spec: type[BaseEngineSpec], name: str) -> dict[str, Any]: + """ + Get documentation metadata for a database engine spec. + + Documentation metadata should be defined in the spec's `metadata` attribute. + If not present, returns minimal fallback with just connection string. + """ + # Check if the spec has metadata attribute with content + if spec_metadata := getattr(spec, "metadata", {}): + result = dict(spec_metadata) + # Ensure category is present + if "category" not in result: + result["category"] = infer_category(name) + return result + + # Minimal fallback for specs without metadata + return { + "pypi_packages": [], + "connection_string": getattr(spec, "sqlalchemy_uri_placeholder", ""), + "category": infer_category(name), + } + + +def generate_yaml_docs(output_dir: str | None = None) -> dict[str, dict[str, Any]]: + """ + Generate YAML documentation files for all database engine specs. + + Args: + output_dir: Directory to write YAML files. If None, returns dict only. + + Returns: + Dictionary mapping database names to their full documentation data. + """ + all_docs: dict[str, dict[str, Any]] = {} + + for spec in sorted(load_engine_specs(), key=get_name): + # Skip non-superset modules (3rd party) + if not spec.__module__.startswith("superset"): + continue + + name = get_name(spec) + doc_data = diagnose(spec) + + # Get documentation metadata (prefers spec.metadata over DATABASE_DOCS) + doc_data["documentation"] = get_documentation_metadata(spec, name) + + # Add engine spec metadata + doc_data["engine"] = spec.engine + doc_data["engine_name"] = name + doc_data["engine_aliases"] = list(getattr(spec, "engine_aliases", set())) + doc_data["default_driver"] = getattr(spec, "default_driver", None) + doc_data["supports_file_upload"] = spec.supports_file_upload + doc_data["supports_dynamic_schema"] = spec.supports_dynamic_schema + doc_data["supports_catalog"] = spec.supports_catalog + + all_docs[name] = doc_data + + if output_dir: + os.makedirs(output_dir, exist_ok=True) + + # Write individual YAML files for each database + for name, data in all_docs.items(): + # Create a safe filename + safe_name = name.lower().replace(" ", "-").replace(".", "") + filepath = os.path.join(output_dir, f"{safe_name}.yaml") + with open(filepath, "w") as f: + yaml.dump( + {name: data}, + f, + default_flow_style=False, + sort_keys=False, + allow_unicode=True, + ) + + # Also write a combined index file + index_filepath = os.path.join(output_dir, "_index.yaml") + with open(index_filepath, "w") as f: + yaml.dump( + all_docs, + f, + default_flow_style=False, + sort_keys=False, + allow_unicode=True, + ) + + print(f"Generated {len(all_docs)} YAML files in {output_dir}") + + return all_docs + + if __name__ == "__main__": + import argparse + from superset.app import create_app + parser = argparse.ArgumentParser(description="Generate database documentation") + parser.add_argument( + "--format", + choices=["markdown", "yaml"], + default="markdown", + help="Output format (default: markdown)", + ) + parser.add_argument( + "--output-dir", + type=str, + default=None, + help="Directory for YAML output files", + ) + args = parser.parse_args() + app = create_app() with app.app_context(): - output = generate_feature_tables() - - print(output) + if args.format == "yaml": + output_dir = args.output_dir or "docs/static/databases" + docs = generate_yaml_docs(output_dir) + print(f"\nGenerated documentation for {len(docs)} databases") + else: + output = generate_feature_tables() + print(output) diff --git a/superset/db_engine_specs/lint_metadata.py b/superset/db_engine_specs/lint_metadata.py new file mode 100644 index 00000000000..2b06ccf250f --- /dev/null +++ b/superset/db_engine_specs/lint_metadata.py @@ -0,0 +1,705 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. + +""" +Metadata completeness linter for DB engine specs. + +This script validates that all DB engine specs have complete metadata +as defined by the DBEngineSpecMetadata TypedDict in base.py. + +Usage: + python superset/db_engine_specs/lint_metadata.py [--json] [--strict] + +Options: + --json Output results as JSON + --strict Return non-zero exit code if any required fields are missing + --help Show this help message + +The script categorizes metadata fields into: +- REQUIRED: Must be present for proper documentation +- RECOMMENDED: Should be present for good documentation +- OPTIONAL: Nice to have but not critical + +Example output: + === Metadata Completeness Report === + + PostgreSQL (postgres.py) + ✓ description, category, pypi_packages, connection_string + ⚠ Missing recommended: logo, homepage_url + + MySQL (mysql.py) + ✓ All required and recommended fields present +""" + +from __future__ import annotations + +import argparse +import json # noqa: TID251 - standalone script, don't depend on superset.utils +import sys +from dataclasses import dataclass +from typing import Any + +# Schema definition - fields grouped by importance +REQUIRED_FIELDS = { + "description": "Brief description of the database", + "categories": "List of DatabaseCategory constants for grouping", + "pypi_packages": "Python packages needed for connection", + "connection_string": "SQLAlchemy URI template", +} + +RECOMMENDED_FIELDS = { + "logo": "Logo filename (in docs/static/img/databases/)", + "homepage_url": "Official database homepage", + "default_port": "Default port number", +} + +OPTIONAL_FIELDS = { + "docs_url": "Documentation URL", + "sqlalchemy_docs_url": "SQLAlchemy dialect documentation", + "notes": "Additional configuration notes", + "warnings": "Important warnings for users", + "limitations": "Known limitations (no JOINs, row limits, etc.)", + "install_instructions": "How to install the driver", + "version_requirements": "Version compatibility info", + "connection_examples": "Example connection strings", + "authentication_methods": "Supported auth methods", + "drivers": "Available driver options", + "compatible_databases": "Related/compatible databases", + "engine_parameters": "Advanced JSON config options", + "host_examples": "Platform-specific host examples", + "ssl_configuration": "SSL setup documentation", + "advanced_features": "Advanced feature documentation", + "parameters": "Connection parameter descriptions", + "tutorials": "Tutorial links", +} + +# Cache for PyPI package validation +_pypi_cache: dict[str, bool] = {} + + +def check_pypi_package(package_name: str, timeout: float = 5.0) -> bool: + """Check if a package exists on PyPI.""" + import urllib.error + import urllib.request + + # Strip version specifiers and extras + base_name = package_name.split("[")[0].split(">")[0].split("<")[0].split("=")[0] + base_name = base_name.strip() + + if base_name in _pypi_cache: + return _pypi_cache[base_name] + + url = f"https://pypi.org/pypi/{base_name}/json" + try: + req = urllib.request.Request( # noqa: S310 + url, headers={"User-Agent": "superset-lint/1.0"} + ) + with urllib.request.urlopen(req, timeout=timeout) as response: # noqa: S310 + exists = response.status == 200 + except (urllib.error.HTTPError, urllib.error.URLError, TimeoutError): + exists = False + + _pypi_cache[base_name] = exists + return exists + + +def validate_pypi_packages( + packages: list[str], timeout: float = 5.0 +) -> tuple[list[str], list[str]]: + """Validate a list of PyPI packages. Returns (valid, invalid) lists.""" + valid = [] + invalid = [] + for pkg in packages: + if check_pypi_package(pkg, timeout): + valid.append(pkg) + else: + invalid.append(pkg) + return valid, invalid + + +@dataclass +class MetadataReport: + """Report for a single engine spec's metadata.""" + + engine_name: str + module: str + has_metadata: bool + present_fields: set[str] + missing_required: set[str] + missing_recommended: set[str] + missing_optional: set[str] + completeness_score: float # 0-100 + invalid_packages: list[str] | None = None # PyPI packages that don't exist + limitations: list[str] | None = None # Known limitations + + def to_dict(self) -> dict[str, Any]: + result = { + "engine_name": self.engine_name, + "module": self.module, + "has_metadata": self.has_metadata, + "present_fields": sorted(self.present_fields), + "missing_required": sorted(self.missing_required), + "missing_recommended": sorted(self.missing_recommended), + "missing_optional": sorted(self.missing_optional), + "completeness_score": self.completeness_score, + } + if self.invalid_packages is not None: + result["invalid_packages"] = self.invalid_packages + if self.limitations is not None: + result["limitations"] = self.limitations + return result + + +def analyze_spec(spec_data: dict[str, Any], check_pypi: bool = False) -> MetadataReport: + """Analyze a single engine spec for metadata completeness.""" + metadata = spec_data.get("metadata", {}) + engine_name = spec_data.get("engine_name", spec_data.get("class_name", "Unknown")) + module = spec_data.get("module", "unknown") + + # Handle unparseable metadata + if metadata.get("_unparseable"): + metadata = {} + + present = set(metadata.keys()) if metadata else set() + missing_required = set(REQUIRED_FIELDS.keys()) - present + missing_recommended = set(RECOMMENDED_FIELDS.keys()) - present + missing_optional = set(OPTIONAL_FIELDS.keys()) - present + + # Calculate completeness score + # Required fields: 60%, Recommended: 30%, Optional: 10% + total_required = len(REQUIRED_FIELDS) + total_recommended = len(RECOMMENDED_FIELDS) + total_optional = len(OPTIONAL_FIELDS) + + required_present = total_required - len(missing_required) + recommended_present = total_recommended - len(missing_recommended) + optional_present = total_optional - len(missing_optional) + + score = ( + (required_present / total_required) * 60 + + (recommended_present / total_recommended) * 30 + + (optional_present / total_optional) * 10 + ) + + # Validate PyPI packages if requested + invalid_packages = None + if check_pypi and metadata.get("pypi_packages"): + packages = metadata.get("pypi_packages", []) + if packages: + _, invalid_packages = validate_pypi_packages(packages) + + # Extract limitations + limitations = metadata.get("limitations") if metadata else None + + return MetadataReport( + engine_name=engine_name, + module=module, + has_metadata=bool(metadata), + present_fields=present, + missing_required=missing_required, + missing_recommended=missing_recommended, + missing_optional=missing_optional, + completeness_score=round(score, 1), + invalid_packages=invalid_packages, + limitations=limitations, + ) + + +def get_all_engine_specs_ast() -> list[dict[str, Any]]: # noqa: C901 + """ + Discover all DB engine specs using AST parsing. + + This avoids needing to initialize the Flask app. + Returns a list of dicts with engine_name, module, and metadata. + """ + import ast + import os + + specs = [] + db_engine_specs_dir = os.path.dirname(__file__) + + for filename in os.listdir(db_engine_specs_dir): + if not filename.endswith(".py"): + continue + if filename in ("__init__.py", "base.py", "lint_metadata.py", "lib.py"): + continue + + filepath = os.path.join(db_engine_specs_dir, filename) + try: + with open(filepath) as f: + content = f.read() + + tree = ast.parse(content) + + # Find all class definitions that inherit from *EngineSpec + for node in ast.walk(tree): + if not isinstance(node, ast.ClassDef): + continue + + # Check if it looks like an engine spec class + is_engine_spec = any( + "EngineSpec" in ast.unparse(base) + if hasattr(ast, "unparse") + else True + for base in node.bases + ) + + if not is_engine_spec: + continue + + # Skip mixins + if "Mixin" in node.name: + continue + + # Check for engine attribute with non-empty value to distinguish + # true base classes from product classes like OceanBaseEngineSpec + has_non_empty_engine = False + for item in node.body: + if isinstance(item, ast.Assign): + for target in item.targets: + if isinstance(target, ast.Name) and target.id == "engine": + # Check if engine value is non-empty string + if isinstance(item.value, ast.Constant): + has_non_empty_engine = bool(item.value.value) + break + + # Skip true base classes (no engine or empty engine attribute) + if node.name.endswith("BaseEngineSpec") and not has_non_empty_engine: + continue + + # Extract engine_name and metadata + engine_name = node.name + metadata = {} + + for item in node.body: + if isinstance(item, ast.Assign): + for target in item.targets: + if isinstance(target, ast.Name): + if target.id == "engine_name": + if isinstance(item.value, ast.Constant): + engine_name = item.value.value + elif target.id == "metadata": + try: + metadata = _eval_ast_dict(item.value) + except Exception: + # Mark as unparseable + metadata = {"_unparseable": True} + + specs.append( + { + "class_name": node.name, + "engine_name": engine_name, + "module": filename[:-3], # Remove .py + "metadata": metadata, + } + ) + + except Exception as e: + print(f"Warning: Could not parse {filename}: {e}", file=sys.stderr) + + return sorted(specs, key=lambda s: s["engine_name"]) + + +def _eval_ast_dict(node: Any) -> dict[str, Any]: + """Safely evaluate an AST node as a dict literal.""" + import ast + + if isinstance(node, ast.Dict): + result = {} + for k, v in zip(node.keys, node.values, strict=False): + if k is None: + continue + key = _eval_ast_value(k) + value = _eval_ast_value(v) + if key is not None: + result[key] = value + return result + return {} + + +def _eval_ast_value(node: Any) -> Any: # noqa: C901 + """Safely evaluate an AST node as a value.""" + import ast + + if isinstance(node, ast.Constant): + return node.value + elif isinstance(node, ast.Str): # Python 3.7 compat + return node.s + elif isinstance(node, ast.Num): # Python 3.7 compat + return node.n + elif isinstance(node, ast.List): + return [_eval_ast_value(e) for e in node.elts] + elif isinstance(node, ast.Dict): + return _eval_ast_dict(node) + elif isinstance(node, ast.Name): + # Handle DatabaseCategory.* constants + return node.id + elif isinstance(node, ast.Attribute): + # Handle DatabaseCategory.TRADITIONAL_RDBMS etc + if hasattr(ast, "unparse"): + return ast.unparse(node) + return f"{_eval_ast_value(node.value)}.{node.attr}" + elif isinstance(node, ast.BinOp) and isinstance(node.op, ast.Add): + # String concatenation + left = _eval_ast_value(node.left) + right = _eval_ast_value(node.right) + if isinstance(left, str) and isinstance(right, str): + return left + right + return None + elif isinstance(node, ast.JoinedStr): + # f-strings - just return placeholder + return "" + elif isinstance(node, ast.Tuple): + return tuple(_eval_ast_value(e) for e in node.elts) + return None + + +def get_all_engine_specs() -> list[type]: + """Discover all DB engine specs using Flask app (if available).""" + # Import here to avoid issues when running standalone + from superset.db_engine_specs import load_engine_specs + + specs = [] + for spec in load_engine_specs(): + # Skip base classes and internal specs + if spec.__name__ in ("BaseEngineSpec", "BasicParametersMixin"): + continue + specs.append(spec) + + return sorted(specs, key=lambda s: getattr(s, "engine_name", s.__name__)) + + +def print_report(reports: list[MetadataReport], verbose: bool = False) -> None: # noqa: C901 + """Print a human-readable report.""" + print("\n" + "=" * 60) + print("METADATA COMPLETENESS REPORT") + print("=" * 60 + "\n") + + # Summary statistics + total = len(reports) + with_metadata = sum(1 for r in reports if r.has_metadata) + fully_complete = sum(1 for r in reports if not r.missing_required) + avg_score = sum(r.completeness_score for r in reports) / total if total else 0 + + print(f"Total engine specs: {total}") + print(f"With metadata: {with_metadata} ({with_metadata * 100 // total}%)") + print( + f"All required fields: {fully_complete} ({fully_complete * 100 // total}%)" + ) + print(f"Average completeness: {avg_score:.1f}%") + print() + + # Group by completeness + complete = [ + r for r in reports if not r.missing_required and not r.missing_recommended + ] + needs_work = [r for r in reports if r.missing_required or r.missing_recommended] + no_metadata = [r for r in reports if not r.has_metadata] + + if complete: + print(f"\n✅ COMPLETE ({len(complete)} specs - all required & recommended):") + print("-" * 50) + for r in complete: + print(f" {r.engine_name:30} {r.completeness_score:5.1f}%") + + if needs_work: + print(f"\n⚠️ NEEDS WORK ({len(needs_work)} specs):") + print("-" * 50) + for r in sorted(needs_work, key=lambda x: -x.completeness_score): + status = [] + if r.missing_required: + status.append( + f"missing required: {', '.join(sorted(r.missing_required))}" + ) + if r.missing_recommended: + status.append( + f"missing recommended: {', '.join(sorted(r.missing_recommended))}" + ) + print(f" {r.engine_name:30} {r.completeness_score:5.1f}%") + for s in status: + print(f" └─ {s}") + + if no_metadata: + print(f"\n❌ NO METADATA ({len(no_metadata)} specs):") + print("-" * 50) + for r in no_metadata: + print(f" {r.engine_name} ({r.module}.py)") + + # Show invalid PyPI packages + invalid_pypi = [r for r in reports if r.invalid_packages] + if invalid_pypi: + print(f"\n📦 INVALID PyPI PACKAGES ({len(invalid_pypi)} specs):") + print("-" * 50) + for r in invalid_pypi: + packages = r.invalid_packages or [] + print(f" {r.engine_name}: {', '.join(packages)}") + + # Field coverage summary + print("\n" + "=" * 60) + print("FIELD COVERAGE SUMMARY") + print("=" * 60) + + all_fields = {**REQUIRED_FIELDS, **RECOMMENDED_FIELDS, **OPTIONAL_FIELDS} + field_counts: dict[str, int] = {f: 0 for f in all_fields} + + for r in reports: + for field in r.present_fields: + if field in field_counts: + field_counts[field] += 1 + + print("\nRequired fields:") + for field, _desc in REQUIRED_FIELDS.items(): + count = field_counts[field] + pct = count * 100 // total + bar = "█" * (pct // 5) + "░" * (20 - pct // 5) + print(f" {field:25} {bar} {count:3}/{total} ({pct}%)") + + print("\nRecommended fields:") + for field, _desc in RECOMMENDED_FIELDS.items(): + count = field_counts[field] + pct = count * 100 // total + bar = "█" * (pct // 5) + "░" * (20 - pct // 5) + print(f" {field:25} {bar} {count:3}/{total} ({pct}%)") + + if verbose: + print("\nOptional fields:") + for field, _desc in OPTIONAL_FIELDS.items(): + count = field_counts[field] + pct = count * 100 // total + bar = "█" * (pct // 5) + "░" * (20 - pct // 5) + print(f" {field:25} {bar} {count:3}/{total} ({pct}%)") + + +def generate_markdown_report(reports: list[MetadataReport]) -> str: + """Generate a markdown report suitable for checking into the repo.""" + lines = [ + "", + "", + "# Database Metadata Completeness Report", + "", + "This report is auto-generated by " + "`python superset/db_engine_specs/lint_metadata.py --markdown`.", + "It tracks which database engine specs have complete metadata.", + "", + "## Summary", + "", + ] + + total = len(reports) + with_metadata = sum(1 for r in reports if r.has_metadata) + all_required = sum(1 for r in reports if not r.missing_required) + avg_score = sum(r.completeness_score for r in reports) / total if total else 0 + + pct_meta = with_metadata * 100 // total + pct_req = all_required * 100 // total + lines.extend( + [ + f"- **Total engine specs:** {total}", + f"- **With metadata:** {with_metadata} ({pct_meta}%)", + f"- **All required fields:** {all_required} ({pct_req}%)", + f"- **Average completeness:** {avg_score:.1f}%", + "", + "## Required Fields", + "", + "These fields should be in every engine spec's `metadata` attribute:", + "", + ] + ) + + for field, desc in REQUIRED_FIELDS.items(): + lines.append(f"- `{field}` - {desc}") + + lines.extend( + [ + "", + "## Specs Needing Work", + "", + "| Engine | Module | Score | Missing Required | Missing Recommended |", + "|--------|--------|-------|------------------|---------------------|", + ] + ) + + # Sort by score ascending (worst first) + needs_work = [r for r in reports if r.missing_required or r.missing_recommended] + for r in sorted(needs_work, key=lambda x: x.completeness_score): + missing_req = ", ".join(sorted(r.missing_required)) or "✓" + missing_rec = ", ".join(sorted(r.missing_recommended)) or "✓" + score = f"{r.completeness_score:.0f}%" + row = f"| {r.engine_name} | {r.module}.py | {score} | {missing_req} | {missing_rec} |" # noqa: E501 + lines.append(row) + + lines.extend( + [ + "", + "## Complete Specs", + "", + "These specs have all required and recommended fields:", + "", + ] + ) + + complete = [ + r for r in reports if not r.missing_required and not r.missing_recommended + ] + for r in sorted(complete, key=lambda x: x.engine_name): + lines.append(f"- {r.engine_name} ({r.completeness_score:.0f}%)") + + lines.extend( + [ + "", + "## How to Fix", + "", + "Add a `metadata` attribute to your engine spec class:", + "", + "```python", + "from superset.db_engine_specs.base import (", # noqa: E501 + " BaseEngineSpec, DatabaseCategory", + ")", + "", + "class MyEngineSpec(BaseEngineSpec):", + ' engine_name = "My Database"', + "", + " metadata = {", + ' "description": "Brief description of the database.",', + ' "categories": [DatabaseCategory.TRADITIONAL_RDBMS],', + ' "pypi_packages": ["my-driver"],', + ' "connection_string": "mydb://{username}:{password}@{host}:{port}/{database}",', + ' "logo": "mydb.svg",', + ' "homepage_url": "https://mydb.example.com/",', + ' "default_port": 5432,', + " }", + "```", + "", + "See `superset/db_engine_specs/README.md` for full documentation.", + "", + ] + ) + + return "\n".join(lines) + + +def main() -> int: + parser = argparse.ArgumentParser( + description="Lint DB engine spec metadata for completeness" + ) + parser.add_argument("--json", action="store_true", help="Output as JSON") + parser.add_argument( + "--markdown", action="store_true", help="Output as Markdown report" + ) + parser.add_argument( + "--strict", + action="store_true", + help="Exit with error if required fields missing", + ) + parser.add_argument( + "--check-pypi", + action="store_true", + help="Validate that pypi_packages exist on PyPI (slower)", + ) + parser.add_argument( + "--verbose", "-v", action="store_true", help="Show optional field coverage" + ) + parser.add_argument("--output", "-o", type=str, help="Write output to file") + args = parser.parse_args() + + # Use AST parsing to avoid Flask app dependency + specs = get_all_engine_specs_ast() + + if not specs: + print("Error: No engine specs found.", file=sys.stderr) + return 1 + + if args.check_pypi: + print("Validating PyPI packages (this may take a moment)...", file=sys.stderr) + + reports = [analyze_spec(spec, check_pypi=args.check_pypi) for spec in specs] + + # Generate output + output_text = "" + if args.json: + output_data = { + "summary": { + "total": len(reports), + "with_metadata": sum(1 for r in reports if r.has_metadata), + "all_required": sum(1 for r in reports if not r.missing_required), + "average_score": round( + sum(r.completeness_score for r in reports) / len(reports), 1 + ), + }, + "schema": { + "required": REQUIRED_FIELDS, + "recommended": RECOMMENDED_FIELDS, + "optional": OPTIONAL_FIELDS, + }, + "reports": [r.to_dict() for r in reports], + } + output_text = json.dumps(output_data, indent=2) + elif args.markdown: + output_text = generate_markdown_report(reports) + else: + print_report(reports, verbose=args.verbose) + + # Write to file or stdout + if output_text: + if args.output: + with open(args.output, "w") as f: + f.write(output_text) + print(f"Report written to {args.output}", file=sys.stderr) + else: + print(output_text) + + # In strict mode, fail if specs WITH metadata are missing required fields. + # Specs without metadata are intentionally internal/legacy and are allowed. + if args.strict: + # Only count specs that HAVE metadata but are incomplete + missing_count = sum(1 for r in reports if r.has_metadata and r.missing_required) + invalid_pypi_count = sum(1 for r in reports if r.invalid_packages) + + if missing_count > 0: + print( + f"\n❌ STRICT MODE: {missing_count} specs missing required fields", + file=sys.stderr, + ) + return 1 + + if args.check_pypi and invalid_pypi_count > 0: + msg = f"\n❌ STRICT MODE: {invalid_pypi_count} specs have invalid packages" + print(msg, file=sys.stderr) + return 1 + + return 0 + + +if __name__ == "__main__": + sys.exit(main()) diff --git a/superset/db_engine_specs/mariadb.py b/superset/db_engine_specs/mariadb.py index 176c3d7ec62..52c11b55e20 100644 --- a/superset/db_engine_specs/mariadb.py +++ b/superset/db_engine_specs/mariadb.py @@ -14,9 +14,24 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. +from superset.db_engine_specs.base import DatabaseCategory from superset.db_engine_specs.mysql import MySQLEngineSpec class MariaDBEngineSpec(MySQLEngineSpec): engine = "mariadb" engine_name = "MariaDB" + + metadata = { + "description": "MariaDB is a community-developed fork of MySQL.", + "logo": "mariadb.png", + "homepage_url": "https://mariadb.org/", + "categories": [ + DatabaseCategory.TRADITIONAL_RDBMS, + DatabaseCategory.OPEN_SOURCE, + ], + "pypi_packages": ["mysqlclient"], + "connection_string": "mysql://{username}:{password}@{host}/{database}", + "default_port": 3306, + "notes": "Uses the MySQL driver. Fully compatible with MySQL connector.", + } diff --git a/superset/db_engine_specs/monetdb.py b/superset/db_engine_specs/monetdb.py new file mode 100644 index 00000000000..1cf60b266b0 --- /dev/null +++ b/superset/db_engine_specs/monetdb.py @@ -0,0 +1,75 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. + +from superset.constants import TimeGrain +from superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory + + +class MonetDbEngineSpec(BaseEngineSpec): + """Engine spec for MonetDB + + MonetDB is an open-source column-oriented relational database management system + designed for high performance on complex queries against large databases. + """ + + engine = "monetdb" + engine_name = "MonetDB" + default_driver = "pymonetdb" + + metadata = { + "description": ( + "MonetDB is an open-source column-oriented relational database " + "for high-performance analytics." + ), + "logo": "monet-db.png", + "homepage_url": "https://www.monetdb.org/", + "categories": [ + DatabaseCategory.TRADITIONAL_RDBMS, + DatabaseCategory.OPEN_SOURCE, + ], + "pypi_packages": ["sqlalchemy-monetdb", "pymonetdb"], + "connection_string": "monetdb://{username}:{password}@{host}:{port}/{database}", + "default_port": 50000, + "parameters": { + "username": "Database username (default: monetdb)", + "password": "Database password (default: monetdb)", + "host": "MonetDB server host", + "port": "Default 50000", + "database": "Database name", + }, + "docs_url": "https://www.monetdb.org/documentation/", + } + + _time_grain_expressions = { + None: "{col}", + TimeGrain.SECOND: "CAST(FLOOR(EXTRACT(EPOCH FROM {col})) AS TIMESTAMP)", + TimeGrain.MINUTE: ( + "CAST({col} AS TIMESTAMP) - " + "CAST(EXTRACT(SECOND FROM {col}) AS INTERVAL SECOND)" + ), + TimeGrain.HOUR: ( + "CAST({col} AS TIMESTAMP) - " + "CAST(EXTRACT(MINUTE FROM {col}) AS INTERVAL MINUTE) - " + "CAST(EXTRACT(SECOND FROM {col}) AS INTERVAL SECOND)" + ), + TimeGrain.DAY: "CAST({col} AS DATE)", + TimeGrain.MONTH: ( + "CAST(EXTRACT(YEAR FROM {col}) || '-' || " + "LPAD(CAST(EXTRACT(MONTH FROM {col}) AS VARCHAR), 2, '0') || '-01' AS DATE)" + ), + TimeGrain.YEAR: "CAST(EXTRACT(YEAR FROM {col}) || '-01-01' AS DATE)", + } diff --git a/superset/db_engine_specs/mongodb.py b/superset/db_engine_specs/mongodb.py new file mode 100644 index 00000000000..03ea7dc4b92 --- /dev/null +++ b/superset/db_engine_specs/mongodb.py @@ -0,0 +1,125 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +"""MongoDB engine spec for Superset. + +Uses PyMongoSQL (https://github.com/passren/PyMongoSQL) as the SQLAlchemy dialect +to enable SQL queries on MongoDB collections. +""" + +from __future__ import annotations + +from datetime import datetime +from typing import Any, Optional + +from sqlalchemy import types + +from superset.constants import TimeGrain +from superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory + + +class MongoDBEngineSpec(BaseEngineSpec): + """Engine spec for MongoDB using PyMongoSQL dialect.""" + + engine = "mongodb" + engine_name = "MongoDB" + force_column_alias_quotes = False + + metadata = { + "description": ("MongoDB is a document-oriented, operational NoSQL database."), + "logo": "mongodb.png", + "homepage_url": "https://www.mongodb.com/", + "categories": [ + DatabaseCategory.SEARCH_NOSQL, + DatabaseCategory.PROPRIETARY, + ], + "pypi_packages": ["pymongosql"], + "connection_string": ( + "mongodb://{username}:{password}@{host}:{port}/{database}?mode=superset" + ), + "parameters": { + "username": "Username for MongoDB", + "password": "Password for MongoDB", + "host": "MongoDB host", + "port": "MongoDB port", + "database": "Database name", + }, + "drivers": [ + { + "name": "MongoDB Atlas Cloud", + "pypi_package": "pymongosql", + "connection_string": "mongodb+srv://{username}:{password}@{host}/{database}?mode=superset", + "notes": "For MongoDB Atlas cloud service.", + "is_recommended": True, + }, + { + "name": "MongoDB Cluster", + "pypi_package": "pymongosql", + "connection_string": "mongodb://{username}:{password}@{host}:{port}/{database}?mode=superset", + "is_recommended": False, + "notes": ("For self-hosted MongoDB instances."), + }, + ], + "notes": "Uses PartiQL for SQL queries. Requires mode=superset parameter.", + "docs_url": "https://github.com/passren/PyMongoSQL", + } + + _time_grain_expressions = { + None: "{col}", + TimeGrain.SECOND: "DATETIME(STRFTIME('%Y-%m-%dT%H:%M:%S', {col}))", + TimeGrain.MINUTE: "DATETIME(STRFTIME('%Y-%m-%dT%H:%M:00', {col}))", + TimeGrain.HOUR: "DATETIME(STRFTIME('%Y-%m-%dT%H:00:00', {col}))", + TimeGrain.DAY: "DATETIME({col}, 'start of day')", + TimeGrain.WEEK: ( + "DATETIME({col}, 'start of day', -strftime('%w', {col}) || ' days')" + ), + TimeGrain.MONTH: "DATETIME({col}, 'start of month')", + TimeGrain.QUARTER: ( + "DATETIME({col}, 'start of month', " + "printf('-%d month', (strftime('%m', {col}) - 1) % 3))" + ), + TimeGrain.YEAR: "DATETIME({col}, 'start of year')", + TimeGrain.WEEK_ENDING_SATURDAY: "DATETIME({col}, 'start of day', 'weekday 6')", + TimeGrain.WEEK_ENDING_SUNDAY: "DATETIME({col}, 'start of day', 'weekday 0')", + TimeGrain.WEEK_STARTING_SUNDAY: ( + "DATETIME({col}, 'start of day', 'weekday 0', '-7 days')" + ), + TimeGrain.WEEK_STARTING_MONDAY: ( + "DATETIME({col}, 'start of day', 'weekday 1', '-7 days')" + ), + } + + @classmethod + def epoch_to_dttm(cls) -> str: + return "datetime({col}, 'unixepoch')" + + @classmethod + def convert_dttm( + cls, + target_type: str, + dttm: datetime, + db_extra: Optional[dict[str, Any]] = None, + ) -> Optional[str]: + """Convert Python datetime to MongoDB/SQL datetime string.""" + sqla_type = cls.get_sqla_column_type(target_type) + + if isinstance( + sqla_type, (types.String, types.DateTime, types.Date, types.TIMESTAMP) + ): + # Return ISO format datetime string for MongoDB compatibility + return f"""{dttm.isoformat(sep=" ", timespec="seconds")!r}""" + + return None diff --git a/superset/db_engine_specs/mssql.py b/superset/db_engine_specs/mssql.py index 6e238e9ddfb..3a8bdfa8dbe 100644 --- a/superset/db_engine_specs/mssql.py +++ b/superset/db_engine_specs/mssql.py @@ -27,7 +27,7 @@ from sqlalchemy import types from sqlalchemy.dialects.mssql.base import SMALLDATETIME from superset.constants import TimeGrain -from superset.db_engine_specs.base import BaseEngineSpec +from superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory from superset.errors import SupersetErrorType from superset.models.sql_types.mssql_sql_types import GUID from superset.utils.core import GenericDataType @@ -52,6 +52,41 @@ CONNECTION_HOST_DOWN_REGEX = re.compile( class MssqlEngineSpec(BaseEngineSpec): engine = "mssql" engine_name = "Microsoft SQL Server" + + metadata = { + "description": ( + "Microsoft SQL Server is a relational database management system." + ), + "logo": "msql.png", + "homepage_url": "https://www.microsoft.com/en-us/sql-server", + "categories": [ + DatabaseCategory.TRADITIONAL_RDBMS, + DatabaseCategory.PROPRIETARY, + ], + "pypi_packages": ["pymssql"], + "connection_string": "mssql+pymssql://{username}:{password}@{host}:{port}/{database}", + "default_port": 1433, + "drivers": [ + { + "name": "pymssql", + "pypi_package": "pymssql", + "connection_string": "mssql+pymssql://{username}:{password}@{host}:{port}/{database}", + "is_recommended": True, + }, + { + "name": "pyodbc", + "pypi_package": "pyodbc", + "connection_string": "mssql+pyodbc:///?odbc_connect=Driver%3D%7BODBC+Driver+17+for+SQL+Server%7D%3BServer%3Dtcp%3A%3C{host}%3E%2C1433%3BDatabase%3D{database}%3BUid%3D{username}%3BPwd%3D{password}%3BEncrypt%3Dyes%3BConnection+Timeout%3D30", + "is_recommended": False, + "notes": ( + "Connection string must be URL-encoded. " + "Special characters like @ need encoding." + ), + }, + ], + "docs_url": "https://docs.sqlalchemy.org/en/20/core/engines.html#escaping-special-characters-such-as-signs-in-passwords", + } + max_column_name_length = 128 allows_cte_in_subquery = False supports_multivalues_insert = True @@ -168,3 +203,22 @@ class AzureSynapseSpec(MssqlEngineSpec): engine = "mssql" engine_name = "Azure Synapse" default_driver = "pyodbc" + + metadata = { + "description": ( + "Azure Synapse Analytics is a cloud-based enterprise data warehouse " + "from Microsoft that combines big data and data warehousing." + ), + "logo": "azure.svg", + "homepage_url": "https://azure.microsoft.com/en-us/products/synapse-analytics/", + "categories": [ + DatabaseCategory.CLOUD_DATA_WAREHOUSES, + DatabaseCategory.ANALYTICAL_DATABASES, + DatabaseCategory.PROPRIETARY, + ], + "pypi_packages": ["pymssql"], + "connection_string": ( + "mssql+pymssql://{username}@{server}:{password}@" + "{server}.database.windows.net:1433/{database}" + ), + } diff --git a/superset/db_engine_specs/mysql.py b/superset/db_engine_specs/mysql.py index 8c071f8dab6..19554d5b9c8 100644 --- a/superset/db_engine_specs/mysql.py +++ b/superset/db_engine_specs/mysql.py @@ -39,7 +39,11 @@ from sqlalchemy.dialects.mysql import ( from sqlalchemy.engine.url import URL from superset.constants import TimeGrain -from superset.db_engine_specs.base import BaseEngineSpec, BasicParametersMixin +from superset.db_engine_specs.base import ( + BaseEngineSpec, + BasicParametersMixin, + DatabaseCategory, +) from superset.errors import SupersetErrorType from superset.models.sql_lab import Query from superset.utils.core import GenericDataType @@ -76,6 +80,104 @@ class MySQLEngineSpec(BasicParametersMixin, BaseEngineSpec): supports_dynamic_schema = True supports_multivalues_insert = True + metadata = { + "description": "MySQL is a popular open-source relational database.", + "logo": "mysql.png", + "homepage_url": "https://www.mysql.com/", + "categories": [ + DatabaseCategory.TRADITIONAL_RDBMS, + DatabaseCategory.OPEN_SOURCE, + ], + "pypi_packages": ["mysqlclient"], + "connection_string": "mysql://{username}:{password}@{host}/{database}", + "default_port": 3306, + "parameters": { + "username": "Database username", + "password": "Database password", + "host": "localhost, 127.0.0.1, IP address, or hostname", + "database": "Database name", + }, + "host_examples": [ + {"platform": "Localhost", "host": "localhost or 127.0.0.1"}, + {"platform": "Docker on Linux", "host": "172.18.0.1"}, + {"platform": "Docker on macOS", "host": "docker.for.mac.host.internal"}, + {"platform": "On-premise", "host": "IP address or hostname"}, + ], + "drivers": [ + { + "name": "mysqlclient", + "pypi_package": "mysqlclient", + "connection_string": ( + "mysql://{username}:{password}@{host}/{database}" + ), + "is_recommended": True, + "notes": ( + "Recommended driver. May fail with caching_sha2_password auth." + ), + }, + { + "name": "mysql-connector-python", + "pypi_package": "mysql-connector-python", + "connection_string": ( + "mysql+mysqlconnector://{username}:{password}@{host}/{database}" + ), + "is_recommended": False, + "notes": ( + "Required for newer MySQL databases using " + "caching_sha2_password authentication." + ), + }, + ], + "compatible_databases": [ + { + "name": "MariaDB", + "description": ( + "MariaDB is a community-developed fork of MySQL, " + "fully compatible with MySQL." + ), + "logo": "mariadb.png", + "homepage_url": "https://mariadb.org/", + "pypi_packages": ["mysqlclient"], + "connection_string": ( + "mysql://{username}:{password}@{host}:{port}/{database}" + ), + "categories": [DatabaseCategory.OPEN_SOURCE], + }, + { + "name": "Amazon Aurora MySQL", + "description": ( + "Amazon Aurora MySQL is a fully managed, MySQL-compatible " + "relational database with up to 5x the throughput of " + "standard MySQL." + ), + "logo": "aws-aurora.jpg", + "homepage_url": "https://aws.amazon.com/rds/aurora/", + "pypi_packages": ["sqlalchemy-aurora-data-api"], + "connection_string": ( + "mysql+auroradataapi://{aws_access_id}:{aws_secret_access_key}@/" + "{database_name}?aurora_cluster_arn={aurora_cluster_arn}&" + "secret_arn={secret_arn}®ion_name={region_name}" + ), + "parameters": { + "aws_access_id": "AWS Access Key ID", + "aws_secret_access_key": "AWS Secret Access Key", + "database_name": "Database name", + "aurora_cluster_arn": "Aurora cluster ARN", + "secret_arn": "Secrets Manager ARN for credentials", + "region_name": "AWS region (e.g., us-east-1)", + }, + "notes": ( + "Uses the Data API for serverless access. " + "Standard MySQL connections also work with mysqlclient." + ), + "categories": [ + DatabaseCategory.CLOUD_AWS, + DatabaseCategory.HOSTED_OPEN_SOURCE, + ], + }, + ], + } + column_type_mappings = ( ( re.compile(r"^int.*", re.IGNORECASE), diff --git a/superset/db_engine_specs/netezza.py b/superset/db_engine_specs/netezza.py index 66b7eeeea6f..c007b0a0301 100644 --- a/superset/db_engine_specs/netezza.py +++ b/superset/db_engine_specs/netezza.py @@ -15,6 +15,7 @@ # specific language governing permissions and limitations # under the License. from superset.constants import TimeGrain +from superset.db_engine_specs.base import DatabaseCategory from superset.db_engine_specs.postgres import PostgresBaseEngineSpec @@ -23,6 +24,19 @@ class NetezzaEngineSpec(PostgresBaseEngineSpec): default_driver = "nzpy" engine_name = "IBM Netezza Performance Server" + metadata = { + "description": "IBM Netezza Performance Server is a data warehouse appliance.", + "logo": "netezza.png", + "homepage_url": "https://www.ibm.com/products/netezza", + "categories": [ + DatabaseCategory.TRADITIONAL_RDBMS, + DatabaseCategory.PROPRIETARY, + ], + "pypi_packages": ["nzalchemy"], + "connection_string": "netezza+nzpy://{username}:{password}@{hostname}:{port}/{database}", + "default_port": 5480, + } + _time_grain_expressions = { None: "{col}", TimeGrain.SECOND: "DATE_TRUNC('second', {col})", diff --git a/superset/db_engine_specs/oceanbase.py b/superset/db_engine_specs/oceanbase.py index 3f4e2d4ed9c..ebc47abdfab 100644 --- a/superset/db_engine_specs/oceanbase.py +++ b/superset/db_engine_specs/oceanbase.py @@ -23,6 +23,7 @@ from flask_babel import gettext as __ from sqlalchemy import Numeric, TEXT, types from sqlalchemy.sql.type_api import TypeEngine +from superset.db_engine_specs.base import DatabaseCategory from superset.db_engine_specs.mysql import MySQLEngineSpec from superset.errors import SupersetErrorType from superset.utils.core import GenericDataType @@ -83,6 +84,18 @@ class OceanBaseEngineSpec(MySQLEngineSpec): encryption_parameters = {"ssl": "0"} supports_dynamic_schema = True + metadata = { + "description": "OceanBase is a distributed relational database.", + "logo": "oceanbase.svg", + "homepage_url": "https://www.oceanbase.com/", + "categories": [ + DatabaseCategory.TRADITIONAL_RDBMS, + DatabaseCategory.OPEN_SOURCE, + ], + "pypi_packages": ["oceanbase_py"], + "connection_string": "oceanbase://{username}:{password}@{host}:{port}/{database}", + } + column_type_mappings = ( # type: ignore ( re.compile(r"^tinyint", re.IGNORECASE), diff --git a/superset/db_engine_specs/ocient.py b/superset/db_engine_specs/ocient.py index 44c30006299..06cb552bb16 100644 --- a/superset/db_engine_specs/ocient.py +++ b/superset/db_engine_specs/ocient.py @@ -35,7 +35,7 @@ with contextlib.suppress(ImportError, RuntimeError): # pyocient may not be inst pyocient.logger.setLevel(superset_log_level) from superset.constants import TimeGrain -from superset.db_engine_specs.base import BaseEngineSpec +from superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory from superset.errors import SupersetErrorType from superset.models.core import Database from superset.models.sql_lab import Query @@ -236,6 +236,17 @@ class OcientEngineSpec(BaseEngineSpec): query_id_mapping: dict[str, str] = {} query_id_mapping_lock = threading.Lock() + metadata = { + "description": "Ocient is a hyperscale data analytics database.", + "categories": [ + DatabaseCategory.ANALYTICAL_DATABASES, + DatabaseCategory.PROPRIETARY, + ], + "pypi_packages": ["sqlalchemy-ocient"], + "connection_string": "ocient://{username}:{password}@{host}:{port}/{database}", + "install_instructions": "pip install sqlalchemy-ocient", + } + custom_errors: dict[Pattern[str], tuple[str, SupersetErrorType, dict[str, Any]]] = { CONNECTION_INVALID_USERNAME_REGEX: ( __('The username "%(username)s" does not exist.'), diff --git a/superset/db_engine_specs/oracle.py b/superset/db_engine_specs/oracle.py index e40223730b1..238eeee778a 100644 --- a/superset/db_engine_specs/oracle.py +++ b/superset/db_engine_specs/oracle.py @@ -20,12 +20,27 @@ from typing import Any, Optional from sqlalchemy import types from superset.constants import TimeGrain -from superset.db_engine_specs.base import BaseEngineSpec +from superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory class OracleEngineSpec(BaseEngineSpec): engine = "oracle" engine_name = "Oracle" + + metadata = { + "description": "Oracle Database is a multi-model database management system.", + "logo": "oraclelogo.png", + "homepage_url": "https://www.oracle.com/database/", + "categories": [ + DatabaseCategory.TRADITIONAL_RDBMS, + DatabaseCategory.PROPRIETARY, + ], + "pypi_packages": ["oracledb"], + "connection_string": "oracle://{username}:{password}@{hostname}:{port}", + "default_port": 1521, + "notes": "Previously used cx_Oracle, now uses oracledb.", + "docs_url": "https://cx-oracle.readthedocs.io/en/latest/user_guide/installation.html", + } force_column_alias_quotes = True max_column_name_length = 128 supports_multivalues_insert = True diff --git a/superset/db_engine_specs/parseable.py b/superset/db_engine_specs/parseable.py index 9be780c949f..ce816633ee3 100644 --- a/superset/db_engine_specs/parseable.py +++ b/superset/db_engine_specs/parseable.py @@ -22,7 +22,7 @@ from typing import Any, TYPE_CHECKING from sqlalchemy import types from superset.constants import TimeGrain -from superset.db_engine_specs.base import BaseEngineSpec +from superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory from superset.utils.core import QuerySource if TYPE_CHECKING: @@ -36,6 +36,31 @@ class ParseableEngineSpec(BaseEngineSpec): engine = "parseable" engine_name = "Parseable" + metadata = { + "description": ( + "Parseable is a distributed log analytics database " + "with SQL-like query interface." + ), + "categories": [DatabaseCategory.SEARCH_NOSQL, DatabaseCategory.OPEN_SOURCE], + "pypi_packages": ["sqlalchemy-parseable"], + "connection_string": ( + "parseable://{username}:{password}@{hostname}:{port}/{stream_name}" + ), + "connection_examples": [ + { + "description": "Example connection", + "connection_string": ( + "parseable://admin:admin@demo.parseable.com:443/ingress-nginx" + ), + }, + ], + "notes": ( + "Stream name in URI represents the Parseable logstream to query. " + "Supports HTTP (80) and HTTPS (443)." + ), + "docs_url": "https://www.parseable.io", + } + _time_grain_expressions = { None: "{col}", TimeGrain.SECOND: "date_trunc('second', {col})", diff --git a/superset/db_engine_specs/pinot.py b/superset/db_engine_specs/pinot.py index 5d6190db12b..9e0b8a888da 100644 --- a/superset/db_engine_specs/pinot.py +++ b/superset/db_engine_specs/pinot.py @@ -19,7 +19,7 @@ from sqlalchemy.engine.interfaces import Dialect from sqlalchemy.types import TypeEngine from superset.constants import TimeGrain -from superset.db_engine_specs.base import BaseEngineSpec +from superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory class PinotEngineSpec(BaseEngineSpec): @@ -31,6 +31,40 @@ class PinotEngineSpec(BaseEngineSpec): allows_alias_in_select = False allows_alias_in_orderby = False + metadata = { + "description": "Apache Pinot is a real-time distributed OLAP datastore.", + "logo": "apache-pinot.svg", + "homepage_url": "https://pinot.apache.org/", + "categories": [ + DatabaseCategory.APACHE_PROJECTS, + DatabaseCategory.TIME_SERIES, + DatabaseCategory.OPEN_SOURCE, + ], + "pypi_packages": ["pinotdb"], + "connection_string": ( + "pinot+http://{broker_host}:{broker_port}/query" + "?controller=http://{controller_host}:{controller_port}/" + ), + "default_port": 8099, + "connection_examples": [ + { + "description": "With authentication", + "connection_string": ( + "pinot://{username}:{password}@{broker_host}:{broker_port}/query/sql" + "?controller=http://{controller_host}:{controller_port}/verify_ssl=true" + ), + }, + ], + "engine_parameters": [ + { + "name": "Multi-stage Query Engine", + "description": "Enable for Explore view, joins, window functions", + "json": {"connect_args": {"use_multistage_engine": "true"}}, + "docs_url": "https://docs.pinot.apache.org/reference/multi-stage-engine", + }, + ], + } + # https://docs.pinot.apache.org/users/user-guide-query/supported-transformations#datetime-functions _time_grain_expressions = { None: "{col}", diff --git a/superset/db_engine_specs/postgres.py b/superset/db_engine_specs/postgres.py index b259164e4fb..10458f15c60 100644 --- a/superset/db_engine_specs/postgres.py +++ b/superset/db_engine_specs/postgres.py @@ -31,7 +31,11 @@ from sqlalchemy.engine.url import URL from sqlalchemy.types import Date, DateTime, String from superset.constants import TimeGrain -from superset.db_engine_specs.base import BaseEngineSpec, BasicParametersMixin +from superset.db_engine_specs.base import ( + BaseEngineSpec, + BasicParametersMixin, + DatabaseCategory, +) from superset.errors import ErrorLevel, SupersetError, SupersetErrorType from superset.exceptions import SupersetException, SupersetSecurityException from superset.models.sql_lab import Query @@ -202,6 +206,7 @@ class PostgresBaseEngineSpec(BaseEngineSpec): class PostgresEngineSpec(BasicParametersMixin, PostgresBaseEngineSpec): engine = "postgresql" + engine_name = "PostgreSQL" engine_aliases = {"postgres"} supports_dynamic_schema = True @@ -212,6 +217,142 @@ class PostgresEngineSpec(BasicParametersMixin, PostgresBaseEngineSpec): sqlalchemy_uri_placeholder = ( "postgresql://user:password@host:port/dbname[?key=value&key=value...]" ) + + metadata = { + "description": "PostgreSQL is an advanced open-source relational database.", + "logo": "postgresql.svg", + "homepage_url": "https://www.postgresql.org/", + "categories": [ + DatabaseCategory.TRADITIONAL_RDBMS, + DatabaseCategory.OPEN_SOURCE, + ], + "pypi_packages": ["psycopg2"], + "connection_string": ( + "postgresql://{username}:{password}@{host}:{port}/{database}" + ), + "default_port": 5432, + "parameters": { + "username": "Database username", + "password": "Database password", + "host": "For localhost: localhost or 127.0.0.1. For AWS: endpoint URL", + "port": "Default 5432", + "database": "Database name", + }, + "notes": "The psycopg2 library comes bundled with Superset Docker images.", + "connection_examples": [ + { + "description": "Basic connection", + "connection_string": ( + "postgresql://{username}:{password}@{host}:{port}/{database}" + ), + }, + { + "description": "With SSL required", + "connection_string": ( + "postgresql://{username}:{password}@{host}:{port}/{database}" + "?sslmode=require" + ), + }, + ], + "docs_url": "https://www.postgresql.org/docs/", + "sqlalchemy_docs_url": ( + "https://docs.sqlalchemy.org/en/13/dialects/postgresql.html" + ), + "compatible_databases": [ + { + "name": "Hologres", + "description": ( + "Alibaba Cloud real-time interactive analytics service, " + "fully compatible with PostgreSQL 11." + ), + "logo": "hologres.png", + "homepage_url": "https://www.alibabacloud.com/product/hologres", + "pypi_packages": ["psycopg2"], + "connection_string": ( + "postgresql+psycopg2://{username}:{password}" + "@{host}:{port}/{database}" + ), + "parameters": { + "username": "AccessKey ID of your Alibaba Cloud account", + "password": "AccessKey secret of your Alibaba Cloud account", + "host": "Public endpoint of the Hologres instance", + "port": "Port number of the Hologres instance", + "database": "Name of the Hologres database", + }, + "categories": [DatabaseCategory.PROPRIETARY], + }, + { + "name": "TimescaleDB", + "description": ( + "Open-source relational database for time-series and analytics, " + "built on PostgreSQL." + ), + "logo": "timescale.png", + "homepage_url": "https://www.timescale.com/", + "pypi_packages": ["psycopg2"], + "connection_string": ( + "postgresql://{username}:{password}@{host}:{port}/{database}" + ), + "connection_examples": [ + { + "description": "Timescale Cloud (SSL required)", + "connection_string": ( + "postgresql://{username}:{password}" + "@{host}:{port}/{database}?sslmode=require" + ), + }, + ], + "notes": "psycopg2 comes bundled with Superset Docker images.", + "docs_url": "https://docs.timescale.com/", + "categories": [DatabaseCategory.OPEN_SOURCE], + }, + { + "name": "YugabyteDB", + "description": ("Distributed SQL database built on top of PostgreSQL."), + "logo": "yugabyte.png", + "homepage_url": "https://www.yugabyte.com/", + "pypi_packages": ["psycopg2"], + "connection_string": ( + "postgresql://{username}:{password}@{host}:{port}/{database}" + ), + "notes": "psycopg2 comes bundled with Superset Docker images.", + "docs_url": "https://www.yugabyte.com/", + "categories": [DatabaseCategory.OPEN_SOURCE], + }, + { + "name": "Amazon Aurora PostgreSQL", + "description": ( + "Amazon Aurora PostgreSQL is a fully managed, " + "PostgreSQL-compatible relational database with up to 5x " + "the throughput of standard PostgreSQL." + ), + "logo": "aws-aurora.jpg", + "homepage_url": "https://aws.amazon.com/rds/aurora/", + "pypi_packages": ["sqlalchemy-aurora-data-api"], + "connection_string": ( + "postgresql+auroradataapi://{aws_access_id}:{aws_secret_access_key}@/" + "{database_name}?aurora_cluster_arn={aurora_cluster_arn}&" + "secret_arn={secret_arn}®ion_name={region_name}" + ), + "parameters": { + "aws_access_id": "AWS Access Key ID", + "aws_secret_access_key": "AWS Secret Access Key", + "database_name": "Database name", + "aurora_cluster_arn": "Aurora cluster ARN", + "secret_arn": "Secrets Manager ARN for credentials", + "region_name": "AWS region (e.g., us-east-1)", + }, + "notes": ( + "Uses the Data API for serverless access. " + "Standard PostgreSQL connections also work with psycopg2." + ), + "categories": [ + DatabaseCategory.CLOUD_AWS, + DatabaseCategory.HOSTED_OPEN_SOURCE, + ], + }, + ], + } # https://www.postgresql.org/docs/9.1/libpq-ssl.html#LIBQ-SSL-CERTIFICATES encryption_parameters = {"sslmode": "require"} diff --git a/superset/db_engine_specs/presto.py b/superset/db_engine_specs/presto.py index 32c82a6af11..3bbf8750d5e 100644 --- a/superset/db_engine_specs/presto.py +++ b/superset/db_engine_specs/presto.py @@ -44,7 +44,7 @@ from sqlalchemy.sql.expression import ColumnClause, Select from superset import cache_manager, db, is_feature_enabled from superset.common.db_query_status import QueryStatus from superset.constants import TimeGrain -from superset.db_engine_specs.base import BaseEngineSpec +from superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory from superset.db_engine_specs.exceptions import SupersetDBAPIProgrammingError from superset.errors import SupersetErrorType from superset.exceptions import SupersetTemplateException @@ -896,6 +896,30 @@ class PrestoEngineSpec(PrestoBaseEngineSpec): engine_name = "Presto" allows_alias_to_source_column = False + metadata = { + "description": "Presto is a distributed SQL query engine for big data.", + "logo": "presto-og.png", + "homepage_url": "https://prestodb.io/", + "categories": [DatabaseCategory.QUERY_ENGINES, DatabaseCategory.OPEN_SOURCE], + "pypi_packages": ["pyhive"], + "install_instructions": 'pip install "apache-superset[presto]"', + "connection_string": "presto://{hostname}:{port}/{database}", + "default_port": 8080, + "parameters": { + "hostname": "Presto coordinator hostname", + "port": "Presto coordinator port (default 8080)", + "database": "Catalog name", + }, + "drivers": [ + { + "name": "PyHive", + "pypi_package": "pyhive", + "connection_string": "presto://{hostname}:{port}/{database}", + "is_recommended": True, + }, + ], + } + custom_errors: dict[Pattern[str], tuple[str, SupersetErrorType, dict[str, Any]]] = { COLUMN_DOES_NOT_EXIST_REGEX: ( __( diff --git a/superset/db_engine_specs/redshift.py b/superset/db_engine_specs/redshift.py index 49dcd4e983c..ea49c479dea 100644 --- a/superset/db_engine_specs/redshift.py +++ b/superset/db_engine_specs/redshift.py @@ -25,7 +25,7 @@ import pandas as pd from flask_babel import gettext as __ from sqlalchemy.types import NVARCHAR -from superset.db_engine_specs.base import BasicParametersMixin +from superset.db_engine_specs.base import BasicParametersMixin, DatabaseCategory from superset.db_engine_specs.postgres import PostgresBaseEngineSpec from superset.errors import SupersetErrorType from superset.models.core import Database @@ -69,6 +69,86 @@ class RedshiftEngineSpec(BasicParametersMixin, PostgresBaseEngineSpec): encryption_parameters = {"sslmode": "verify-ca"} + metadata = { + "description": "Amazon Redshift is a fully managed data warehouse service.", + "logo": "redshift.png", + "homepage_url": "https://aws.amazon.com/redshift/", + "categories": [ + DatabaseCategory.CLOUD_AWS, + DatabaseCategory.ANALYTICAL_DATABASES, + DatabaseCategory.PROPRIETARY, + ], + "pypi_packages": ["sqlalchemy-redshift"], + "connection_string": "redshift+psycopg2://{username}:{password}@{host}:5439/{database}", + "default_port": 5439, + "parameters": { + "username": "Database username", + "password": "Database password", + "host": "AWS Endpoint", + "port": "Default 5439", + "database": "Database name", + }, + "drivers": [ + { + "name": "psycopg2", + "pypi_package": "psycopg2", + "connection_string": ( + "redshift+psycopg2://{username}:{password}@{host}:5439/{database}" + ), + "is_recommended": True, + }, + { + "name": "redshift_connector", + "pypi_package": "redshift_connector", + "connection_string": ( + "redshift+redshift_connector://{username}:{password}" + "@{host}:5439/{database}" + ), + "is_recommended": False, + "notes": "Supports IAM-based credentials for clusters and serverless.", + }, + ], + "authentication_methods": [ + { + "name": "IAM Credentials (Cluster)", + "description": ( + "Use IAM-based temporary database credentials for Redshift clusters" + ), + "requirements": ( + "IAM role must have redshift:GetClusterCredentials permission" + ), + "connection_string": "redshift+redshift_connector://", + "engine_parameters": { + "connect_args": { + "iam": True, + "database": "", + "cluster_identifier": "", + "db_user": "", + } + }, + }, + { + "name": "IAM Credentials (Serverless)", + "description": "Use IAM-based credentials for Redshift Serverless", + "requirements": ( + "IAM role must have redshift-serverless:GetCredentials " + "and redshift-serverless:GetWorkgroup permissions" + ), + "connection_string": "redshift+redshift_connector://", + "engine_parameters": { + "connect_args": { + "iam": True, + "is_serverless": True, + "serverless_acct_id": "", + "serverless_work_group": "", + "database": "", + "user": "IAMR:", + } + }, + }, + ], + } + custom_errors: dict[Pattern[str], tuple[str, SupersetErrorType, dict[str, Any]]] = { CONNECTION_ACCESS_DENIED_REGEX: ( __('Either the username "%(username)s" or the password is incorrect.'), @@ -103,6 +183,24 @@ class RedshiftEngineSpec(BasicParametersMixin, PostgresBaseEngineSpec): ), } + @classmethod + def normalize_table_name_for_upload( + cls, + table_name: str, + schema_name: str | None = None, + ) -> tuple[str, str | None]: + """ + Redshift folds unquoted identifiers to lowercase. + + :param table_name: The table name to normalize + :param schema_name: The schema name to normalize (optional) + :return: Tuple of (normalized_table_name, normalized_schema_name) + """ + return ( + table_name.lower(), + schema_name.lower() if schema_name else None, + ) + @classmethod def df_to_sql( cls, diff --git a/superset/db_engine_specs/risingwave.py b/superset/db_engine_specs/risingwave.py index 9ca0b1977fd..1a4c9cfe91b 100644 --- a/superset/db_engine_specs/risingwave.py +++ b/superset/db_engine_specs/risingwave.py @@ -14,6 +14,7 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. +from superset.db_engine_specs.base import DatabaseCategory from superset.db_engine_specs.postgres import PostgresEngineSpec @@ -24,3 +25,19 @@ class RisingWaveDbEngineSpec(PostgresEngineSpec): sqlalchemy_uri_placeholder = ( "risingwave://user:password@host:port/dbname[?key=value&key=value...]" ) + + metadata = { + "description": "RisingWave is a distributed streaming database.", + "logo": "risingwave.png", + "homepage_url": "https://risingwave.com/", + "categories": [ + DatabaseCategory.ANALYTICAL_DATABASES, + DatabaseCategory.OPEN_SOURCE, + ], + "pypi_packages": ["sqlalchemy-risingwave"], + "connection_string": ( + "risingwave://root@{hostname}:{port}/{database}?sslmode=disable" + ), + "default_port": 4566, + "docs_url": "https://github.com/risingwavelabs/sqlalchemy-risingwave", + } diff --git a/superset/db_engine_specs/shillelagh.py b/superset/db_engine_specs/shillelagh.py index 61820824b02..d353c0b89f8 100644 --- a/superset/db_engine_specs/shillelagh.py +++ b/superset/db_engine_specs/shillelagh.py @@ -18,6 +18,7 @@ from __future__ import annotations from typing import TYPE_CHECKING +from superset.db_engine_specs.base import DatabaseCategory from superset.db_engine_specs.sqlite import SqliteEngineSpec if TYPE_CHECKING: @@ -36,6 +37,22 @@ class ShillelaghEngineSpec(SqliteEngineSpec): allows_joins = True allows_subqueries = True + metadata = { + "description": ( + "Shillelagh is a Python library that allows querying many data sources " + "using SQL, including Google Sheets, CSV files, and APIs." + ), + "logo": "shillelagh.png", + "homepage_url": "https://shillelagh.readthedocs.io/", + "categories": [DatabaseCategory.OTHER, DatabaseCategory.OPEN_SOURCE], + "pypi_packages": ["shillelagh[gsheetsapi]"], + "connection_string": "shillelagh://", + "notes": ( + "Shillelagh uses virtual tables to query external data sources. " + "Google Sheets requires OAuth credentials configured." + ), + } + @classmethod def get_function_names( cls, diff --git a/superset/db_engine_specs/singlestore.py b/superset/db_engine_specs/singlestore.py index 27df97ff9b9..c6e9692abe0 100644 --- a/superset/db_engine_specs/singlestore.py +++ b/superset/db_engine_specs/singlestore.py @@ -30,6 +30,7 @@ from superset.db_engine_specs.base import ( BaseEngineSpec, BasicParametersMixin, ColumnTypeMapping, + DatabaseCategory, LimitMethod, ) from superset.models.core import Database @@ -46,6 +47,41 @@ class SingleStoreSpec(BasicParametersMixin, BaseEngineSpec): drivers = {"singlestoredb": "SingleStore Python client"} default_driver = "singlestoredb" + metadata = { + "description": ( + "SingleStore is a distributed SQL database for real-time analytics " + "and transactions." + ), + "logo": "singlestore.png", + "homepage_url": "https://www.singlestore.com/", + "categories": [ + DatabaseCategory.ANALYTICAL_DATABASES, + DatabaseCategory.PROPRIETARY, + ], + "pypi_packages": ["singlestoredb"], + "connection_string": ( + "singlestoredb://{username}:{password}@{host}:{port}/{database}" + ), + "default_port": 3306, + "parameters": { + "username": "Database username", + "password": "Database password", + "host": "SingleStore host", + "port": "SingleStore port (default 3306)", + "database": "Database name", + }, + "drivers": [ + { + "name": "singlestoredb", + "pypi_package": "singlestoredb", + "connection_string": ( + "singlestoredb://{username}:{password}@{host}:{port}/{database}" + ), + "is_recommended": True, + }, + ], + } + limit_method = LimitMethod.FORCE_LIMIT allows_joins = True allows_subqueries = True diff --git a/superset/db_engine_specs/snowflake.py b/superset/db_engine_specs/snowflake.py index 5b9df25f111..3f541699f05 100644 --- a/superset/db_engine_specs/snowflake.py +++ b/superset/db_engine_specs/snowflake.py @@ -36,7 +36,11 @@ from sqlalchemy.engine.url import URL from superset.constants import TimeGrain from superset.databases.utils import make_url_safe -from superset.db_engine_specs.base import BaseEngineSpec, BasicPropertiesType +from superset.db_engine_specs.base import ( + BaseEngineSpec, + BasicPropertiesType, + DatabaseCategory, +) from superset.db_engine_specs.postgres import PostgresBaseEngineSpec from superset.errors import ErrorLevel, SupersetError, SupersetErrorType from superset.models.sql_lab import Query @@ -93,6 +97,58 @@ class SnowflakeEngineSpec(PostgresBaseEngineSpec): supports_dynamic_schema = True supports_catalog = supports_dynamic_catalog = supports_cross_catalog_queries = True + metadata = { + "description": "Snowflake is a cloud-native data warehouse.", + "logo": "snowflake.svg", + "homepage_url": "https://www.snowflake.com/", + "categories": [ + DatabaseCategory.CLOUD_DATA_WAREHOUSES, + DatabaseCategory.ANALYTICAL_DATABASES, + DatabaseCategory.PROPRIETARY, + ], + "pypi_packages": ["snowflake-sqlalchemy"], + "connection_string": ( + "snowflake://{user}:{password}@{account}.{region}/{database}" + "?role={role}&warehouse={warehouse}" + ), + "install_instructions": ( + 'echo "snowflake-sqlalchemy" >> ./docker/requirements-local.txt' + ), + "connection_examples": [ + { + "description": "With role and warehouse", + "connection_string": ( + "snowflake://{user}:{password}@{account}.{region}/{database}" + "?role={role}&warehouse={warehouse}" + ), + }, + { + "description": "With defaults (role/warehouse optional)", + "connection_string": ( + "snowflake://{user}:{password}@{account}.{region}/{database}" + ), + }, + ], + "authentication_methods": [ + { + "name": "Key Pair Authentication", + "description": "Use RSA key pair instead of password", + "requirements": ( + "Key pair must be generated and public key registered in Snowflake" + ), + "notes": ( + "Merge multi-line private key to one line with \\n between lines." + ), + }, + ], + "notes": ( + "Schema is not required in connection string. " + "Ensure user has privileges for all " + "databases/schemas/tables/views/warehouses." + ), + "docs_url": "https://docs.snowflake.com/en/user-guide/key-pair-auth.html", + } + # pylint: disable=invalid-name encrypted_extra_sensitive_fields = { "$.auth_params.privatekey_body", diff --git a/superset/db_engine_specs/solr.py b/superset/db_engine_specs/solr.py index bf7ad6429d3..03dca6c2b66 100644 --- a/superset/db_engine_specs/solr.py +++ b/superset/db_engine_specs/solr.py @@ -15,7 +15,7 @@ # specific language governing permissions and limitations # under the License. -from superset.db_engine_specs.base import BaseEngineSpec +from superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory class SolrEngineSpec(BaseEngineSpec): # pylint: disable=abstract-method @@ -28,6 +28,23 @@ class SolrEngineSpec(BaseEngineSpec): # pylint: disable=abstract-method allows_joins = False allows_subqueries = False + metadata = { + "description": "Apache Solr is an open-source enterprise search platform.", + "logo": "apache-solr.png", + "homepage_url": "https://solr.apache.org/", + "categories": [ + DatabaseCategory.APACHE_PROJECTS, + DatabaseCategory.SEARCH_NOSQL, + DatabaseCategory.OPEN_SOURCE, + ], + "pypi_packages": ["sqlalchemy-solr"], + "connection_string": ( + "solr://{username}:{password}@{host}:{port}/{server_path}/{collection}" + "[/?use_ssl=true|false]" + ), + "default_port": 8983, + } + _time_grain_expressions = { None: "{col}", } diff --git a/superset/db_engine_specs/spark.py b/superset/db_engine_specs/spark.py index 95a7bfdaeaf..733a374bf82 100644 --- a/superset/db_engine_specs/spark.py +++ b/superset/db_engine_specs/spark.py @@ -17,6 +17,7 @@ from __future__ import annotations from superset.constants import TimeGrain +from superset.db_engine_specs.base import DatabaseCategory from superset.db_engine_specs.hive import HiveEngineSpec time_grain_expressions: dict[str | None, str] = { @@ -41,3 +42,17 @@ time_grain_expressions: dict[str | None, str] = { class SparkEngineSpec(HiveEngineSpec): _time_grain_expressions = time_grain_expressions engine_name = "Apache Spark SQL" + + metadata = { + "description": "Apache Spark SQL is a module for structured data processing.", + "logo": "apache-spark.png", + "homepage_url": "https://spark.apache.org/sql/", + "categories": [ + DatabaseCategory.APACHE_PROJECTS, + DatabaseCategory.QUERY_ENGINES, + DatabaseCategory.OPEN_SOURCE, + ], + "pypi_packages": ["pyhive"], + "connection_string": "hive://hive@{hostname}:{port}/{database}", + "default_port": 10000, + } diff --git a/superset/db_engine_specs/sqlite.py b/superset/db_engine_specs/sqlite.py index f8604bcfead..c704a120fee 100644 --- a/superset/db_engine_specs/sqlite.py +++ b/superset/db_engine_specs/sqlite.py @@ -27,7 +27,7 @@ from sqlalchemy import types from sqlalchemy.engine.reflection import Inspector from superset.constants import TimeGrain -from superset.db_engine_specs.base import BaseEngineSpec +from superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory from superset.errors import SupersetErrorType if TYPE_CHECKING: @@ -44,6 +44,19 @@ class SqliteEngineSpec(BaseEngineSpec): disable_ssh_tunneling = True supports_multivalues_insert = True + metadata = { + "description": "SQLite is a self-contained, serverless SQL database engine.", + "logo": "sqlite.png", + "homepage_url": "https://www.sqlite.org/", + "categories": [ + DatabaseCategory.TRADITIONAL_RDBMS, + DatabaseCategory.OPEN_SOURCE, + ], + "pypi_packages": [], + "connection_string": "sqlite:///path/to/file.db?check_same_thread=false", + "notes": "No additional library needed. SQLite is bundled with Python.", + } + _time_grain_expressions = { None: "{col}", TimeGrain.SECOND: "DATETIME(STRFTIME('%Y-%m-%dT%H:%M:%S', {col}))", diff --git a/superset/db_engine_specs/starrocks.py b/superset/db_engine_specs/starrocks.py index 00ea3595e7b..c485ce216fe 100644 --- a/superset/db_engine_specs/starrocks.py +++ b/superset/db_engine_specs/starrocks.py @@ -27,6 +27,7 @@ from sqlalchemy.engine.reflection import Inspector from sqlalchemy.engine.url import URL from sqlalchemy.sql.type_api import TypeEngine +from superset.db_engine_specs.base import DatabaseCategory from superset.db_engine_specs.mysql import MySQLEngineSpec from superset.errors import SupersetErrorType from superset.models.core import Database @@ -100,6 +101,90 @@ class StarRocksEngineSpec(MySQLEngineSpec): supports_dynamic_schema = True supports_catalog = supports_dynamic_catalog = supports_cross_catalog_queries = True + metadata = { + "description": ( + "StarRocks is a high-performance analytical database " + "for real-time analytics." + ), + "logo": "starrocks.png", + "homepage_url": "https://www.starrocks.io/", + "categories": [ + DatabaseCategory.ANALYTICAL_DATABASES, + DatabaseCategory.OPEN_SOURCE, + ], + "pypi_packages": ["starrocks"], + "connection_string": ( + "starrocks://{username}:{password}@{host}:{port}/{catalog}.{database}" + ), + "default_port": 9030, + "parameters": { + "username": "Database username", + "password": "Database password", + "host": "StarRocks FE host", + "port": "Query port (default 9030)", + "catalog": "Catalog name", + "database": "Database name", + }, + "drivers": [ + { + "name": "starrocks", + "pypi_package": "starrocks", + "connection_string": ( + "starrocks://{username}:{password}@{host}:{port}/{catalog}.{database}" + ), + "is_recommended": True, + }, + { + "name": "mysqlclient", + "pypi_package": "mysqlclient", + "connection_string": ( + "mysql://{username}:{password}@{host}:{port}/{database}" + ), + "is_recommended": False, + "notes": "MySQL-compatible driver for StarRocks.", + }, + { + "name": "PyMySQL", + "pypi_package": "pymysql", + "connection_string": ( + "mysql+pymysql://{username}:{password}@{host}:{port}/{database}" + ), + "is_recommended": False, + "notes": "Pure Python MySQL driver, no compilation required.", + }, + ], + "compatible_databases": [ + { + "name": "CelerData", + "description": ( + "CelerData is a fully-managed cloud analytics service built on " + "StarRocks. It provides instant elasticity, automatic scaling, " + "and enterprise features." + ), + "logo": "celerdata.png", + "homepage_url": "https://celerdata.com/", + "categories": [ + DatabaseCategory.ANALYTICAL_DATABASES, + DatabaseCategory.CLOUD_DATA_WAREHOUSES, + DatabaseCategory.HOSTED_OPEN_SOURCE, + ], + "pypi_packages": ["starrocks"], + "connection_string": ( + "starrocks://{username}:{password}@{host}:{port}/{catalog}.{database}" + ), + "parameters": { + "username": "CelerData username", + "password": "CelerData password", + "host": "CelerData cluster endpoint", + "port": "Query port (default 9030)", + "catalog": "Catalog name", + "database": "Database name", + }, + "docs_url": "https://docs.celerdata.com/", + }, + ], + } + column_type_mappings = ( # type: ignore ( re.compile(r"^tinyint", re.IGNORECASE), diff --git a/superset/db_engine_specs/superset.py b/superset/db_engine_specs/superset.py index 318af04d13f..f3a0ed5cf3c 100644 --- a/superset/db_engine_specs/superset.py +++ b/superset/db_engine_specs/superset.py @@ -19,6 +19,7 @@ A native Superset database. """ +from superset.db_engine_specs.base import DatabaseCategory from superset.db_engine_specs.shillelagh import ShillelaghEngineSpec @@ -37,3 +38,19 @@ class SupersetEngineSpec(ShillelaghEngineSpec): sqlalchemy_uri_placeholder = "superset://" supports_file_upload = False + + metadata = { + "description": ( + "Superset meta database is an experimental feature that enables " + "querying across multiple configured databases using a single connection." + ), + "logo": "superset.svg", + "homepage_url": "https://superset.apache.org/", + "categories": [DatabaseCategory.OTHER], + "pypi_packages": [], + "connection_string": "superset://", + "notes": ( + "This is an internal Superset feature. Enable with ENABLE_SUPERSET_META_DB " + "feature flag. Allows cross-database queries using virtual tables." + ), + } diff --git a/superset/db_engine_specs/sybase.py b/superset/db_engine_specs/sybase.py new file mode 100644 index 00000000000..f03c6febd65 --- /dev/null +++ b/superset/db_engine_specs/sybase.py @@ -0,0 +1,54 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. + +from superset.db_engine_specs.base import DatabaseCategory +from superset.db_engine_specs.mssql import MssqlEngineSpec + + +class SybaseEngineSpec(MssqlEngineSpec): + """Engine spec for SAP ASE (Sybase) + + SAP Adaptive Server Enterprise (ASE), formerly known as Sybase SQL Server, + is a relational database management system. It uses Transact-SQL (T-SQL) + similar to Microsoft SQL Server. + """ + + engine = "sybase" + engine_name = "SAP Sybase" + engine_aliases = {"sybase_sqlany"} # Support SQL Anywhere dialect too + default_driver = "pyodbc" + + metadata = { + "description": ( + "SAP ASE (formerly Sybase) is an enterprise relational database." + ), + "logo": "sybase.png", + "homepage_url": "https://www.sap.com/products/technology-platform/sybase-ase.html", + "categories": [ + DatabaseCategory.TRADITIONAL_RDBMS, + DatabaseCategory.PROPRIETARY, + ], + "pypi_packages": ["sqlalchemy-sybase", "pyodbc"], + "connection_string": "sybase+pyodbc://{username}:{password}@{dsn}", + "parameters": { + "username": "Database username", + "password": "Database password", + "dsn": "ODBC Data Source Name configured for SAP ASE", + }, + "notes": "Requires SAP ASE ODBC driver installed and configured as a DSN.", + "docs_url": "https://help.sap.com/docs/SAP_ASE", + } diff --git a/superset/db_engine_specs/tdengine.py b/superset/db_engine_specs/tdengine.py index f2910e4228a..19602449ad7 100644 --- a/superset/db_engine_specs/tdengine.py +++ b/superset/db_engine_specs/tdengine.py @@ -21,7 +21,7 @@ from urllib import parse from sqlalchemy.engine.url import make_url, URL # noqa: F401 -from superset.db_engine_specs.base import BaseEngineSpec +from superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory class TDengineEngineSpec(BaseEngineSpec): @@ -33,6 +33,23 @@ class TDengineEngineSpec(BaseEngineSpec): "taosws://user:******@host:port/dbname[?key=value&key=value...]" ) + metadata = { + "description": "TDengine is a high-performance time-series database for IoT.", + "logo": "tdengine.png", + "homepage_url": "https://tdengine.com/", + "categories": [DatabaseCategory.TIME_SERIES, DatabaseCategory.OPEN_SOURCE], + "pypi_packages": ["taospy", "taos-ws-py"], + "connection_string": "taosws://{user}:{password}@{host}:{port}", + "default_port": 6041, + "connection_examples": [ + { + "description": "Local connection", + "connection_string": "taosws://root:taosdata@127.0.0.1:6041", + }, + ], + "docs_url": "https://www.tdengine.com", + } + # time grain _time_grain_expressions = { None: "{col}", diff --git a/superset/db_engine_specs/teradata.py b/superset/db_engine_specs/teradata.py index 881a0a5b248..77f37229f79 100644 --- a/superset/db_engine_specs/teradata.py +++ b/superset/db_engine_specs/teradata.py @@ -15,7 +15,7 @@ # specific language governing permissions and limitations # under the License. -from superset.db_engine_specs.base import BaseEngineSpec +from superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory class TeradataEngineSpec(BaseEngineSpec): @@ -23,6 +23,35 @@ class TeradataEngineSpec(BaseEngineSpec): engine = "teradatasql" engine_name = "Teradata" + + metadata = { + "description": "Teradata is an enterprise data warehouse platform.", + "logo": "teradata.png", + "homepage_url": "https://www.teradata.com/", + "categories": [ + DatabaseCategory.TRADITIONAL_RDBMS, + DatabaseCategory.PROPRIETARY, + ], + "pypi_packages": ["teradatasqlalchemy"], + "connection_string": "teradatasql://{user}:{password}@{host}", + "default_port": 1025, + "drivers": [ + { + "name": "teradatasqlalchemy (Recommended)", + "pypi_package": "teradatasqlalchemy", + "connection_string": "teradatasql://{user}:{password}@{host}", + "is_recommended": True, + "notes": "No ODBC drivers required.", + }, + { + "name": "sqlalchemy-teradata (ODBC)", + "pypi_package": "sqlalchemy-teradata", + "is_recommended": False, + "notes": "Requires ODBC driver installation.", + "docs_url": "https://downloads.teradata.com/download/connectivity/odbc-driver/linux", + }, + ], + } max_column_name_length = 30 # since 14.10 this is 128 _time_grain_expressions = { diff --git a/superset/db_engine_specs/timescaledb.py b/superset/db_engine_specs/timescaledb.py new file mode 100644 index 00000000000..f6d2aa6049c --- /dev/null +++ b/superset/db_engine_specs/timescaledb.py @@ -0,0 +1,62 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. + +from __future__ import annotations + +from superset.db_engine_specs.base import DatabaseCategory +from superset.db_engine_specs.postgres import PostgresBaseEngineSpec + + +class TimescaleDBEngineSpec(PostgresBaseEngineSpec): + """ + Engine spec for TimescaleDB. + + TimescaleDB is an open-source time-series database built on PostgreSQL. + """ + + engine = "timescaledb" + engine_name = "TimescaleDB" + default_driver = "psycopg2" + + metadata = { + "description": ( + "TimescaleDB is an open-source relational database for time-series " + "and analytics, built on PostgreSQL." + ), + "logo": "timescale.png", + "homepage_url": "https://www.timescale.com/", + "categories": [ + DatabaseCategory.ANALYTICAL_DATABASES, + DatabaseCategory.OPEN_SOURCE, + ], + "pypi_packages": ["psycopg2"], + "connection_string": ( + "postgresql://{username}:{password}@{host}:{port}/{database}" + ), + "default_port": 5432, + "connection_examples": [ + { + "description": "Timescale Cloud (SSL required)", + "connection_string": ( + "postgresql://{username}:{password}@{host}:{port}/" + "{database}?sslmode=require" + ), + }, + ], + "notes": "Uses the PostgreSQL driver. psycopg2 comes bundled with Superset.", + "docs_url": "https://docs.timescale.com/", + } diff --git a/superset/db_engine_specs/trino.py b/superset/db_engine_specs/trino.py index 4792ea7292e..62494971728 100644 --- a/superset/db_engine_specs/trino.py +++ b/superset/db_engine_specs/trino.py @@ -25,6 +25,7 @@ from typing import Any, TYPE_CHECKING import requests from flask import copy_current_request_context, ctx, current_app as app, Flask, g +from flask_babel import gettext as __ from sqlalchemy.engine.reflection import Inspector from sqlalchemy.engine.url import URL from sqlalchemy.exc import NoSuchTableError @@ -32,7 +33,11 @@ from sqlalchemy.exc import NoSuchTableError from superset import db from superset.common.db_query_status import QueryStatus from superset.constants import QUERY_CANCEL_KEY, QUERY_EARLY_CANCEL_KEY -from superset.db_engine_specs.base import BaseEngineSpec, convert_inspector_columns +from superset.db_engine_specs.base import ( + BaseEngineSpec, + convert_inspector_columns, + DatabaseCategory, +) from superset.db_engine_specs.exceptions import ( SupersetDBAPIConnectionError, SupersetDBAPIDatabaseError, @@ -76,6 +81,83 @@ class TrinoEngineSpec(PrestoBaseEngineSpec): engine_name = "Trino" allows_alias_to_source_column = False + metadata = { + "description": ( + "Trino is a distributed SQL query engine for big data analytics." + ), + "logo": "trino.png", + "homepage_url": "https://trino.io/", + "categories": [DatabaseCategory.QUERY_ENGINES, DatabaseCategory.OPEN_SOURCE], + "pypi_packages": ["trino"], + "install_instructions": 'pip install "apache-superset[trino]"', + "connection_string": "trino://{username}:{password}@{hostname}:{port}/{catalog}", + "default_port": 8080, + "parameters": { + "username": "Trino username", + "password": "Trino password (if authentication is enabled)", + "hostname": "Trino coordinator hostname", + "port": "Trino coordinator port (default 8080)", + "catalog": "Catalog name", + }, + "drivers": [ + { + "name": "trino", + "pypi_package": "trino", + "connection_string": ( + "trino://{username}:{password}@{hostname}:{port}/{catalog}" + ), + "is_recommended": True, + }, + ], + "compatible_databases": [ + { + "name": "Starburst Galaxy", + "description": ( + "Starburst Galaxy is a fully-managed cloud analytics platform " + "built on Trino. It provides data lake analytics with " + "enterprise security and governance." + ), + "logo": "starburst.png", + "homepage_url": "https://www.starburst.io/platform/starburst-galaxy/", + "categories": [ + DatabaseCategory.QUERY_ENGINES, + DatabaseCategory.CLOUD_DATA_WAREHOUSES, + DatabaseCategory.HOSTED_OPEN_SOURCE, + ], + "pypi_packages": ["trino"], + "connection_string": ( + "trino://{username}:{password}@{host}:{port}/{catalog}" + ), + "parameters": { + "username": "Starburst Galaxy username (email/role)", + "password": "Starburst Galaxy password or token", + "host": "Your Galaxy cluster hostname", + "port": "Port (default 443)", + "catalog": "Catalog name", + }, + "docs_url": "https://docs.starburst.io/starburst-galaxy/", + }, + { + "name": "Starburst Enterprise", + "description": ( + "Starburst Enterprise is a self-managed Trino distribution " + "with enterprise features, security, and support." + ), + "logo": "starburst.png", + "homepage_url": "https://www.starburst.io/platform/starburst-enterprise/", + "categories": [ + DatabaseCategory.QUERY_ENGINES, + DatabaseCategory.HOSTED_OPEN_SOURCE, + ], + "pypi_packages": ["trino"], + "connection_string": ( + "trino://{username}:{password}@{hostname}:{port}/{catalog}" + ), + "docs_url": "https://docs.starburst.io/", + }, + ], + } + # OAuth 2.0 supports_oauth2 = True oauth2_exception = TrinoAuthError @@ -225,14 +307,25 @@ class TrinoEngineSpec(PrestoBaseEngineSpec): ) break + needs_commit = False info = getattr(cursor, "stats", {}) or {} state = info.get("state", "UNKNOWN") completed_splits = float(info.get("completedSplits", 0)) total_splits = float(info.get("totalSplits", 1) or 1) progress = math.floor((completed_splits / (total_splits or 1)) * 100) + progress_text = { + "PLANNING": __("Scheduled"), + "QUEUED": __("Queued"), + }.get(state, state) if progress != query.progress: query.progress = progress + needs_commit = True + if progress_text != query.extra.get("progress_text"): + query.set_extra_json_key(key="progress_text", value=progress_text) + needs_commit = True + + if needs_commit: db.session.commit() # pylint: disable=consider-using-transaction time.sleep(poll_interval) diff --git a/superset/db_engine_specs/vertica.py b/superset/db_engine_specs/vertica.py index 5f3d99c6c54..28e85d4cf49 100644 --- a/superset/db_engine_specs/vertica.py +++ b/superset/db_engine_specs/vertica.py @@ -14,9 +14,32 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. +from superset.db_engine_specs.base import DatabaseCategory from superset.db_engine_specs.postgres import PostgresBaseEngineSpec class VerticaEngineSpec(PostgresBaseEngineSpec): engine = "vertica" engine_name = "Vertica" + + metadata = { + "description": "Vertica is a column-oriented analytics database.", + "logo": "vertica.png", + "homepage_url": "https://www.vertica.com/", + "categories": [ + DatabaseCategory.ANALYTICAL_DATABASES, + DatabaseCategory.PROPRIETARY, + ], + "pypi_packages": ["sqlalchemy-vertica-python"], + "connection_string": "vertica+vertica_python://{username}:{password}@{host}/{database}", + "default_port": 5433, + "parameters": { + "username": "Database username", + "password": "Database password", + "host": "localhost, IP address, or hostname (cloud or on-prem)", + "database": "Database name", + "port": "Default 5433", + }, + "notes": "Supports load balancer backup host configuration.", + "docs_url": "http://www.vertica.com/", + } diff --git a/superset/db_engine_specs/ydb.py b/superset/db_engine_specs/ydb.py index 811c38feaa5..07c0b3d5571 100755 --- a/superset/db_engine_specs/ydb.py +++ b/superset/db_engine_specs/ydb.py @@ -23,7 +23,7 @@ from typing import Any, TYPE_CHECKING from sqlalchemy import types from superset.constants import TimeGrain -from superset.db_engine_specs.base import BaseEngineSpec +from superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory from superset.utils import json if TYPE_CHECKING: @@ -51,6 +51,51 @@ class YDBEngineSpec(BaseEngineSpec): allows_alias_in_orderby = True + metadata = { + "description": "YDB is a distributed SQL database by Yandex.", + "logo": "ydb.svg", + "homepage_url": "https://ydb.tech/", + "categories": [ + DatabaseCategory.TRADITIONAL_RDBMS, + DatabaseCategory.OPEN_SOURCE, + ], + "pypi_packages": ["ydb-sqlalchemy"], + "connection_string": "ydb://{host}:{port}/{database_name}", + "default_port": 2135, + "engine_parameters": [ + { + "name": "Protocol", + "description": "Specify connection protocol (default: grpc)", + "secure_extra": {"protocol": "grpcs"}, + }, + ], + "authentication_methods": [ + { + "name": "Static Credentials", + "description": "Username/password authentication", + "secure_extra": {"credentials": {"username": "...", "password": "..."}}, + }, + { + "name": "Access Token", + "description": "Token-based authentication", + "secure_extra": {"credentials": {"token": "..."}}, + }, + { + "name": "Service Account", + "description": "Service account JSON credentials", + "secure_extra": { + "credentials": { + "service_account_json": { + "id": "...", + "service_account_id": "...", + "private_key": "...", + }, + }, + }, + }, + ], + } + _time_grain_expressions = { None: "{col}", TimeGrain.SECOND: "DateTime::MakeDatetime(DateTime::StartOf({col}, Interval('PT1S')))", # noqa: E501 diff --git a/superset/db_engine_specs/yugabytedb.py b/superset/db_engine_specs/yugabytedb.py new file mode 100644 index 00000000000..21b8a8eb2e7 --- /dev/null +++ b/superset/db_engine_specs/yugabytedb.py @@ -0,0 +1,53 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. + +from __future__ import annotations + +from superset.db_engine_specs.base import DatabaseCategory +from superset.db_engine_specs.postgres import PostgresBaseEngineSpec + + +class YugabyteDBEngineSpec(PostgresBaseEngineSpec): + """ + Engine spec for YugabyteDB. + + YugabyteDB is a distributed SQL database built on top of PostgreSQL. + """ + + engine = "yugabytedb" + engine_name = "YugabyteDB" + default_driver = "psycopg2" + + metadata = { + "description": ( + "YugabyteDB is a distributed SQL database built on top of PostgreSQL." + ), + "logo": "yugabyte.png", + "homepage_url": "https://www.yugabyte.com/", + "categories": [ + DatabaseCategory.CLOUD_DATA_WAREHOUSES, + DatabaseCategory.TRADITIONAL_RDBMS, + DatabaseCategory.OPEN_SOURCE, + ], + "pypi_packages": ["psycopg2"], + "connection_string": ( + "postgresql://{username}:{password}@{host}:{port}/{database}" + ), + "default_port": 5433, + "notes": "Uses the PostgreSQL driver. psycopg2 comes bundled with Superset.", + "docs_url": "https://docs.yugabyte.com/", + } diff --git a/superset/examples/_shared/database.yaml b/superset/examples/_shared/database.yaml new file mode 100644 index 00000000000..c794648a6f2 --- /dev/null +++ b/superset/examples/_shared/database.yaml @@ -0,0 +1,23 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +database_name: examples +sqlalchemy_uri: __SQLALCHEMY_EXAMPLES_URI__ +expose_in_sqllab: true +extra: + allows_virtual_table_explore: true +uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee +version: 1.0.0 diff --git a/superset/examples/configs/metadata.yaml b/superset/examples/_shared/metadata.yaml similarity index 100% rename from superset/examples/configs/metadata.yaml rename to superset/examples/_shared/metadata.yaml diff --git a/superset/examples/bart_lines.py b/superset/examples/bart_lines.py deleted file mode 100644 index 9af12125db3..00000000000 --- a/superset/examples/bart_lines.py +++ /dev/null @@ -1,71 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -import logging - -import polyline -from sqlalchemy import inspect, String, Text - -from superset import db -from superset.sql.parse import Table -from superset.utils import json - -from ..utils.database import get_example_database # noqa: TID252 -from .helpers import get_table_connector_registry, read_example_data - -logger = logging.getLogger(__name__) - - -def load_bart_lines(only_metadata: bool = False, force: bool = False) -> None: - tbl_name = "bart_lines" - database = get_example_database() - with database.get_sqla_engine() as engine: - schema = inspect(engine).default_schema_name - table_exists = database.has_table(Table(tbl_name, schema)) - - if not only_metadata and (not table_exists or force): - df = read_example_data( - "examples://bart-lines.json.gz", encoding="latin-1", compression="gzip" - ) - df["path_json"] = df.path.map(json.dumps) - df["polyline"] = df.path.map(polyline.encode) - del df["path"] - - df.to_sql( - tbl_name, - engine, - schema=schema, - if_exists="replace", - chunksize=500, - dtype={ - "color": String(255), - "name": String(255), - "polyline": Text, - "path_json": Text, - }, - index=False, - ) - - logger.debug("Creating table %s reference", tbl_name) - table = get_table_connector_registry() - tbl = db.session.query(table).filter_by(table_name=tbl_name).first() - if not tbl: - tbl = table(table_name=tbl_name, schema=schema) - db.session.add(tbl) - tbl.description = "BART lines" - tbl.database = database - tbl.filter_select_enabled = True - tbl.fetch_metadata() diff --git a/superset/examples/configs/charts/Featured Charts/Radar.yaml b/superset/examples/configs/charts/Featured Charts/Radar.yaml deleted file mode 100644 index cced959532d..00000000000 --- a/superset/examples/configs/charts/Featured Charts/Radar.yaml +++ /dev/null @@ -1,100 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -slice_name: Radar -description: null -certified_by: null -certification_details: null -viz_type: radar -params: - datasource: 22__table - viz_type: radar - groupby: - - product_line - metrics: - - count - - expressionType: SIMPLE - column: - advanced_data_type: null - certification_details: null - certified_by: null - column_name: price_each - description: null - expression: null - filterable: true - groupby: true - id: 733 - is_certified: false - is_dttm: false - python_date_format: null - type: DOUBLE PRECISION - type_generic: 0 - verbose_name: null - warning_markdown: null - aggregate: AVG - sqlExpression: null - datasourceWarning: false - hasCustomLabel: false - label: AVG(price_each) - optionName: metric_ethqy44wrel_gsqbm609hxt - - expressionType: SIMPLE - column: - advanced_data_type: null - certification_details: null - certified_by: null - column_name: sales - description: null - expression: null - filterable: true - groupby: true - id: 734 - is_certified: false - is_dttm: false - python_date_format: null - type: DOUBLE PRECISION - type_generic: 0 - verbose_name: null - warning_markdown: null - aggregate: AVG - sqlExpression: null - datasourceWarning: false - hasCustomLabel: false - label: AVG(sales) - optionName: metric_r5emvf2ybfe_blvnta3absu - adhoc_filters: - - clause: WHERE - subject: order_date - operator: TEMPORAL_RANGE - comparator: No filter - expressionType: SIMPLE - row_limit: 10 - color_scheme: supersetColors - show_legend: true - legendType: scroll - legendOrientation: top - legendMargin: "" - show_labels: false - label_type: value - label_position: top - number_format: SMART_NUMBER - date_format: smart_date - is_circle: true - extra_form_data: {} - dashboards: [] -cache_timeout: null -uuid: 1be00870-89b8-4ba0-a451-1fe56ef89581 -version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 diff --git a/superset/examples/configs/charts/Vehicle Sales/Items_Sold.yaml b/superset/examples/configs/charts/Vehicle Sales/Items_Sold.yaml deleted file mode 100644 index dfe68196d37..00000000000 --- a/superset/examples/configs/charts/Vehicle Sales/Items_Sold.yaml +++ /dev/null @@ -1,73 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -slice_name: Items Sold -description: null -certified_by: null -certification_details: null -viz_type: big_number -params: - datasource: 21__table - viz_type: big_number - slice_id: 115 - x_axis: order_date - metric: - aggregate: SUM - column: - column_name: quantity_ordered - description: null - expression: null - filterable: true - groupby: true - id: 914 - is_dttm: false - python_date_format: null - type: BIGINT - verbose_name: null - expressionType: SIMPLE - hasCustomLabel: false - isNew: false - label: SUM(Sales) - optionName: metric_twq59hf4ej_g70qjfmehsq - sqlExpression: null - adhoc_filters: - - clause: WHERE - comparator: No filter - expressionType: SIMPLE - operator: TEMPORAL_RANGE - subject: order_date - show_trend_line: true - start_y_axis_at_zero: true - color_picker: - a: 1 - b: 135 - g: 122 - r: 0 - header_font_size: 0.4 - subheader_font_size: 0.15 - y_axis_format: SMART_NUMBER - time_format: smart_date - rolling_type: cumsum - extra_form_data: {} - dashboards: - - 9 -query_context: '{"datasource":{"id":21,"type":"table"},"force":false,"queries":[{"filters":[{"col":"order_date","op":"TEMPORAL_RANGE","val":"No - filter"}],"extras":{"having":"","where":""},"applied_time_extras":{},"columns":[{"columnType":"BASE_AXIS","sqlExpression":"order_date","label":"order_date","expressionType":"SQL"}],"metrics":[{"aggregate":"SUM","column":{"column_name":"quantity_ordered","description":null,"expression":null,"filterable":true,"groupby":true,"id":914,"is_dttm":false,"python_date_format":null,"type":"BIGINT","verbose_name":null},"expressionType":"SIMPLE","hasCustomLabel":false,"isNew":false,"label":"SUM(Sales)","optionName":"metric_twq59hf4ej_g70qjfmehsq","sqlExpression":null}],"annotation_layers":[],"series_limit":0,"order_desc":true,"url_params":{},"custom_params":{},"custom_form_data":{},"post_processing":[{"operation":"pivot","options":{"index":["order_date"],"columns":[],"aggregates":{"SUM(Sales)":{"operator":"mean"}},"drop_missing_columns":true}},{"operation":"cum","options":{"operator":"sum","columns":{"SUM(Sales)":"SUM(Sales)"}}},{"operation":"flatten"}]}],"form_data":{"datasource":"21__table","viz_type":"big_number","slice_id":115,"x_axis":"order_date","metric":{"aggregate":"SUM","column":{"column_name":"quantity_ordered","description":null,"expression":null,"filterable":true,"groupby":true,"id":914,"is_dttm":false,"python_date_format":null,"type":"BIGINT","verbose_name":null},"expressionType":"SIMPLE","hasCustomLabel":false,"isNew":false,"label":"SUM(Sales)","optionName":"metric_twq59hf4ej_g70qjfmehsq","sqlExpression":null},"adhoc_filters":[{"clause":"WHERE","comparator":"No - filter","expressionType":"SIMPLE","operator":"TEMPORAL_RANGE","subject":"order_date"}],"show_trend_line":true,"start_y_axis_at_zero":true,"color_picker":{"a":1,"b":135,"g":122,"r":0},"header_font_size":0.4,"subheader_font_size":0.15,"y_axis_format":"SMART_NUMBER","time_format":"smart_date","rolling_type":"cumsum","extra_form_data":{},"dashboards":[9],"force":false,"result_format":"json","result_type":"full"},"result_format":"json","result_type":"full"}' -cache_timeout: null -uuid: c3d643cd-fd6f-4659-a5b7-59402487a8d0 -version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 diff --git a/superset/examples/configs/charts/Vehicle Sales/Items_by_Product_Line.yaml b/superset/examples/configs/charts/Vehicle Sales/Items_by_Product_Line.yaml deleted file mode 100644 index 9e13c5d952b..00000000000 --- a/superset/examples/configs/charts/Vehicle Sales/Items_by_Product_Line.yaml +++ /dev/null @@ -1,80 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -slice_name: Items by Product Line -description: null -certified_by: null -certification_details: null -viz_type: table -params: - datasource: 21__table - viz_type: table - slice_id: 111 - query_mode: aggregate - groupby: - - product_line - temporal_columns_lookup: - order_date: true - metrics: - - aggregate: SUM - column: - column_name: quantity_ordered - description: null - expression: null - filterable: true - groupby: true - id: 914 - is_dttm: false - optionName: _col_QuantityOrdered - python_date_format: null - type: BIGINT - verbose_name: null - expressionType: SIMPLE - hasCustomLabel: true - isNew: false - label: '# of Products Sold' - optionName: metric_skdbciwba6g_z1r5w1pxlqj - sqlExpression: null - all_columns: [] - percent_metrics: null - adhoc_filters: - - clause: WHERE - subject: order_date - operator: TEMPORAL_RANGE - comparator: No filter - expressionType: SIMPLE - order_by_cols: [] - row_limit: null - order_desc: true - table_timestamp_format: smart_date - allow_render_html: true - show_cell_bars: true - color_pn: true - comparison_color_scheme: Green - comparison_type: values - extra_form_data: {} - dashboards: - - 9 -query_context: '{"datasource":{"id":21,"type":"table"},"force":false,"queries":[{"filters":[{"col":"order_date","op":"TEMPORAL_RANGE","val":"No - filter"}],"extras":{"having":"","where":""},"applied_time_extras":{},"columns":["product_line"],"metrics":[{"aggregate":"SUM","column":{"column_name":"quantity_ordered","description":null,"expression":null,"filterable":true,"groupby":true,"id":914,"is_dttm":false,"optionName":"_col_QuantityOrdered","python_date_format":null,"type":"BIGINT","verbose_name":null},"expressionType":"SIMPLE","hasCustomLabel":true,"isNew":false,"label":"# - of Products Sold","optionName":"metric_skdbciwba6g_z1r5w1pxlqj","sqlExpression":null}],"orderby":[[{"aggregate":"SUM","column":{"column_name":"quantity_ordered","description":null,"expression":null,"filterable":true,"groupby":true,"id":914,"is_dttm":false,"optionName":"_col_QuantityOrdered","python_date_format":null,"type":"BIGINT","verbose_name":null},"expressionType":"SIMPLE","hasCustomLabel":true,"isNew":false,"label":"# - of Products Sold","optionName":"metric_skdbciwba6g_z1r5w1pxlqj","sqlExpression":null},false]],"annotation_layers":[],"series_limit":0,"order_desc":true,"url_params":{},"custom_params":{},"custom_form_data":{},"post_processing":[],"time_offsets":[]}],"form_data":{"datasource":"21__table","viz_type":"table","slice_id":111,"query_mode":"aggregate","groupby":["product_line"],"temporal_columns_lookup":{"order_date":true},"metrics":[{"aggregate":"SUM","column":{"column_name":"quantity_ordered","description":null,"expression":null,"filterable":true,"groupby":true,"id":914,"is_dttm":false,"optionName":"_col_QuantityOrdered","python_date_format":null,"type":"BIGINT","verbose_name":null},"expressionType":"SIMPLE","hasCustomLabel":true,"isNew":false,"label":"# - of Products Sold","optionName":"metric_skdbciwba6g_z1r5w1pxlqj","sqlExpression":null}],"all_columns":[],"percent_metrics":null,"adhoc_filters":[{"clause":"WHERE","subject":"order_date","operator":"TEMPORAL_RANGE","comparator":"No - filter","expressionType":"SIMPLE"}],"order_by_cols":[],"row_limit":null,"order_desc":true,"table_timestamp_format":"smart_date","allow_render_html":true,"show_cell_bars":true,"color_pn":true,"comparison_color_scheme":"Green","comparison_type":"values","extra_form_data":{},"dashboards":[9],"force":false,"result_format":"json","result_type":"full"},"result_format":"json","result_type":"full"}' -cache_timeout: null -uuid: b8b7ca30-6291-44b0-bc64-ba42e2892b86 -version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 diff --git a/superset/examples/configs/charts/Vehicle Sales/Overall_Sales_By_Product_Line.yaml b/superset/examples/configs/charts/Vehicle Sales/Overall_Sales_By_Product_Line.yaml deleted file mode 100644 index 097805a17ea..00000000000 --- a/superset/examples/configs/charts/Vehicle Sales/Overall_Sales_By_Product_Line.yaml +++ /dev/null @@ -1,76 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -slice_name: Overall Sales (By Product Line) -description: null -certified_by: null -certification_details: null -viz_type: pie -params: - adhoc_filters: [] - color_scheme: supersetColors - datasource: 23__table - donut: true - granularity_sqla: order_date - groupby: - - product_line - innerRadius: 41 - label_line: true - labels_outside: true - metric: - aggregate: SUM - column: - column_name: sales - description: null - expression: null - filterable: true - groupby: true - id: 917 - is_dttm: false - optionName: _col_Sales - python_date_format: null - type: DOUBLE PRECISION - verbose_name: null - expressionType: SIMPLE - hasCustomLabel: false - isNew: false - label: (Sales) - optionName: metric_3sk6pfj3m7i_64h77bs4sly - sqlExpression: null - number_format: SMART_NUMBER - outerRadius: 65 - label_type: key - queryFields: - groupby: groupby - metric: metrics - row_limit: null - show_labels: true - show_labels_threshold: 2 - show_legend: false - slice_id: 670 - time_range: No filter - url_params: {} - viz_type: pie - annotation_layers: [] -query_context: '{"datasource":{"id":21,"type":"table"},"force":false,"queries":[{"time_range":"No - filter","granularity":"order_date","filters":[],"extras":{"having":"","where":""},"applied_time_extras":{},"columns":["product_line"],"metrics":[{"aggregate":"SUM","column":{"column_name":"sales","description":null,"expression":null,"filterable":true,"groupby":true,"id":917,"is_dttm":false,"optionName":"_col_Sales","python_date_format":null,"type":"DOUBLE - PRECISION","verbose_name":null},"expressionType":"SIMPLE","hasCustomLabel":false,"isNew":false,"label":"(Sales)","optionName":"metric_3sk6pfj3m7i_64h77bs4sly","sqlExpression":null}],"annotation_layers":[],"series_limit":0,"order_desc":true,"url_params":{},"custom_params":{},"custom_form_data":{}}],"form_data":{"adhoc_filters":[],"annotation_layers":[],"color_scheme":"supersetColors","datasource":"21__table","donut":true,"granularity_sqla":"order_date","groupby":["product_line"],"innerRadius":41,"label_line":true,"label_type":"key","labels_outside":true,"metric":{"aggregate":"SUM","column":{"column_name":"sales","description":null,"expression":null,"filterable":true,"groupby":true,"id":917,"is_dttm":false,"optionName":"_col_Sales","python_date_format":null,"type":"DOUBLE - PRECISION","verbose_name":null},"expressionType":"SIMPLE","hasCustomLabel":false,"isNew":false,"label":"(Sales)","optionName":"metric_3sk6pfj3m7i_64h77bs4sly","sqlExpression":null},"number_format":"SMART_NUMBER","outerRadius":65,"queryFields":{"groupby":"groupby","metric":"metrics"},"row_limit":null,"show_labels":true,"show_labels_threshold":2,"show_legend":false,"slice_id":120,"time_range":"No - filter","url_params":{},"viz_type":"pie","force":false,"result_format":"json","result_type":"full"},"result_format":"json","result_type":"full"}' -cache_timeout: null -uuid: 09c497e0-f442-1121-c9e7-671e37750424 -version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 diff --git a/superset/examples/configs/charts/Vehicle Sales/Proportion_of_Revenue_by_Product_Line.yaml b/superset/examples/configs/charts/Vehicle Sales/Proportion_of_Revenue_by_Product_Line.yaml deleted file mode 100644 index 56b9ab3326b..00000000000 --- a/superset/examples/configs/charts/Vehicle Sales/Proportion_of_Revenue_by_Product_Line.yaml +++ /dev/null @@ -1,99 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -slice_name: Proportion of Revenue by Product Line -description: null -certified_by: null -certification_details: null -viz_type: echarts_area -params: - datasource: 21__table - viz_type: echarts_area - slice_id: 116 - x_axis: order_date - time_grain_sqla: P1M - x_axis_sort_asc: true - x_axis_sort_series: name - x_axis_sort_series_ascending: true - metrics: - - aggregate: SUM - column: - column_name: sales - description: null - expression: null - filterable: true - groupby: true - id: 917 - is_dttm: false - optionName: _col_Sales - python_date_format: null - type: DOUBLE PRECISION - verbose_name: null - expressionType: SIMPLE - hasCustomLabel: false - isNew: false - label: (Sales) - optionName: metric_3is69ofceho_6d0ezok7ry6 - sqlExpression: null - groupby: - - product_line - adhoc_filters: - - clause: WHERE - subject: order_date - operator: TEMPORAL_RANGE - comparator: '2003-01-01T00:00:00 : 2005-06-01T00:00:00' - expressionType: SIMPLE - row_limit: null - truncate_metric: true - show_empty_columns: true - rolling_type: null - comparison_type: values - annotation_layers: [] - forecastPeriods: 10 - forecastInterval: 0.8 - x_axis_title_margin: 15 - y_axis_title_margin: 15 - y_axis_title_position: Left - sort_series_type: sum - color_scheme: supersetColors - time_shift_color: true - seriesType: line - opacity: 0.2 - stack: Stack - only_total: true - markerSize: 6 - show_legend: true - legendType: scroll - legendOrientation: top - x_axis_time_format: smart_date - rich_tooltip: true - showTooltipTotal: true - tooltipTimeFormat: smart_date - y_axis_format: SMART_NUMBER - truncateXAxis: true - extra_form_data: {} - dashboards: - - 9 -query_context: '{"datasource":{"id":21,"type":"table"},"force":false,"queries":[{"filters":[{"col":"order_date","op":"TEMPORAL_RANGE","val":"2003-01-01T00:00:00 - : 2005-06-01T00:00:00"}],"extras":{"time_grain_sqla":"P1M","having":"","where":""},"applied_time_extras":{},"columns":[{"timeGrain":"P1M","columnType":"BASE_AXIS","sqlExpression":"order_date","label":"order_date","expressionType":"SQL"},"product_line"],"metrics":[{"aggregate":"SUM","column":{"column_name":"sales","description":null,"expression":null,"filterable":true,"groupby":true,"id":917,"is_dttm":false,"optionName":"_col_Sales","python_date_format":null,"type":"DOUBLE - PRECISION","verbose_name":null},"expressionType":"SIMPLE","hasCustomLabel":false,"isNew":false,"label":"(Sales)","optionName":"metric_3is69ofceho_6d0ezok7ry6","sqlExpression":null}],"orderby":[[{"aggregate":"SUM","column":{"column_name":"sales","description":null,"expression":null,"filterable":true,"groupby":true,"id":917,"is_dttm":false,"optionName":"_col_Sales","python_date_format":null,"type":"DOUBLE - PRECISION","verbose_name":null},"expressionType":"SIMPLE","hasCustomLabel":false,"isNew":false,"label":"(Sales)","optionName":"metric_3is69ofceho_6d0ezok7ry6","sqlExpression":null},false]],"annotation_layers":[],"series_columns":["product_line"],"series_limit":0,"order_desc":true,"url_params":{},"custom_params":{},"custom_form_data":{},"time_offsets":[],"post_processing":[{"operation":"pivot","options":{"index":["order_date"],"columns":["product_line"],"aggregates":{"(Sales)":{"operator":"mean"}},"drop_missing_columns":false}},{"operation":"rename","options":{"columns":{"(Sales)":null},"level":0,"inplace":true}},{"operation":"flatten"}]}],"form_data":{"datasource":"21__table","viz_type":"echarts_area","slice_id":116,"x_axis":"order_date","time_grain_sqla":"P1M","x_axis_sort_asc":true,"x_axis_sort_series":"name","x_axis_sort_series_ascending":true,"metrics":[{"aggregate":"SUM","column":{"column_name":"sales","description":null,"expression":null,"filterable":true,"groupby":true,"id":917,"is_dttm":false,"optionName":"_col_Sales","python_date_format":null,"type":"DOUBLE - PRECISION","verbose_name":null},"expressionType":"SIMPLE","hasCustomLabel":false,"isNew":false,"label":"(Sales)","optionName":"metric_3is69ofceho_6d0ezok7ry6","sqlExpression":null}],"groupby":["product_line"],"adhoc_filters":[{"clause":"WHERE","subject":"order_date","operator":"TEMPORAL_RANGE","comparator":"2003-01-01T00:00:00 - : 2005-06-01T00:00:00","expressionType":"SIMPLE"}],"row_limit":null,"truncate_metric":true,"show_empty_columns":true,"rolling_type":null,"comparison_type":"values","annotation_layers":[],"forecastPeriods":10,"forecastInterval":0.8,"x_axis_title_margin":15,"y_axis_title_margin":15,"y_axis_title_position":"Left","sort_series_type":"sum","color_scheme":"supersetColors","time_shift_color":true,"seriesType":"line","opacity":0.2,"stack":"Stack","only_total":true,"markerSize":6,"show_legend":true,"legendType":"scroll","legendOrientation":"top","x_axis_time_format":"smart_date","rich_tooltip":true,"showTooltipTotal":true,"tooltipTimeFormat":"smart_date","y_axis_format":"SMART_NUMBER","truncateXAxis":true,"extra_form_data":{},"dashboards":[9],"force":false,"result_format":"json","result_type":"full"},"result_format":"json","result_type":"full"}' -cache_timeout: null -uuid: 08aff161-f60c-4cb3-a225-dc9b1140d2e3 -version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 diff --git a/superset/examples/configs/charts/Vehicle Sales/Quarterly_Sales.yaml b/superset/examples/configs/charts/Vehicle Sales/Quarterly_Sales.yaml deleted file mode 100644 index f1169141c48..00000000000 --- a/superset/examples/configs/charts/Vehicle Sales/Quarterly_Sales.yaml +++ /dev/null @@ -1,101 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -slice_name: Quarterly Sales -description: null -certified_by: null -certification_details: null -viz_type: echarts_timeseries_bar -params: - datasource: 21__table - viz_type: echarts_timeseries_bar - slice_id: 118 - x_axis: order_date - time_grain_sqla: P3M - x_axis_sort_asc: true - x_axis_sort_series: name - x_axis_sort_series_ascending: true - metrics: - - aggregate: SUM - column: - column_name: sales - description: null - expression: null - filterable: true - groupby: true - id: 917 - is_dttm: false - optionName: _col_Sales - python_date_format: null - type: DOUBLE PRECISION - verbose_name: null - expressionType: SIMPLE - hasCustomLabel: false - isNew: false - label: SUM(Sales) - optionName: metric_tjn8bh6y44_7o4etwsqhal - sqlExpression: null - groupby: - - status - adhoc_filters: - - clause: WHERE - subject: order_date - operator: TEMPORAL_RANGE - comparator: No filter - expressionType: SIMPLE - row_limit: 10000 - truncate_metric: true - show_empty_columns: true - rolling_type: null - time_compare: null - comparison_type: null - annotation_layers: [] - forecastPeriods: 10 - forecastInterval: 0.8 - orientation: vertical - x_axis_title_margin: 15 - y_axis_title_margin: 15 - y_axis_title_position: Left - sort_series_type: sum - color_scheme: supersetColors - time_shift_color: true - stack: Stack - only_total: true - show_legend: true - legendType: scroll - legendOrientation: top - x_axis_time_format: smart_date - y_axis_format: null - y_axis_bounds: - - null - - null - truncateXAxis: true - rich_tooltip: true - showTooltipTotal: true - tooltipTimeFormat: smart_date - extra_form_data: {} - dashboards: - - 9 -query_context: '{"datasource":{"id":21,"type":"table"},"force":false,"queries":[{"filters":[{"col":"order_date","op":"TEMPORAL_RANGE","val":"No - filter"}],"extras":{"time_grain_sqla":"P3M","having":"","where":""},"applied_time_extras":{},"columns":[{"timeGrain":"P3M","columnType":"BASE_AXIS","sqlExpression":"order_date","label":"order_date","expressionType":"SQL"},"status"],"metrics":[{"aggregate":"SUM","column":{"column_name":"sales","description":null,"expression":null,"filterable":true,"groupby":true,"id":917,"is_dttm":false,"optionName":"_col_Sales","python_date_format":null,"type":"DOUBLE - PRECISION","verbose_name":null},"expressionType":"SIMPLE","hasCustomLabel":false,"isNew":false,"label":"SUM(Sales)","optionName":"metric_tjn8bh6y44_7o4etwsqhal","sqlExpression":null}],"orderby":[[{"aggregate":"SUM","column":{"column_name":"sales","description":null,"expression":null,"filterable":true,"groupby":true,"id":917,"is_dttm":false,"optionName":"_col_Sales","python_date_format":null,"type":"DOUBLE - PRECISION","verbose_name":null},"expressionType":"SIMPLE","hasCustomLabel":false,"isNew":false,"label":"SUM(Sales)","optionName":"metric_tjn8bh6y44_7o4etwsqhal","sqlExpression":null},false]],"annotation_layers":[],"row_limit":10000,"series_columns":["status"],"series_limit":0,"order_desc":true,"url_params":{},"custom_params":{},"custom_form_data":{},"time_offsets":[],"post_processing":[{"operation":"pivot","options":{"index":["order_date"],"columns":["status"],"aggregates":{"SUM(Sales)":{"operator":"mean"}},"drop_missing_columns":false}},{"operation":"rename","options":{"columns":{"SUM(Sales)":null},"level":0,"inplace":true}},{"operation":"flatten"}]}],"form_data":{"datasource":"21__table","viz_type":"echarts_timeseries_bar","slice_id":118,"x_axis":"order_date","time_grain_sqla":"P3M","x_axis_sort_asc":true,"x_axis_sort_series":"name","x_axis_sort_series_ascending":true,"metrics":[{"aggregate":"SUM","column":{"column_name":"sales","description":null,"expression":null,"filterable":true,"groupby":true,"id":917,"is_dttm":false,"optionName":"_col_Sales","python_date_format":null,"type":"DOUBLE - PRECISION","verbose_name":null},"expressionType":"SIMPLE","hasCustomLabel":false,"isNew":false,"label":"SUM(Sales)","optionName":"metric_tjn8bh6y44_7o4etwsqhal","sqlExpression":null}],"groupby":["status"],"adhoc_filters":[{"clause":"WHERE","subject":"order_date","operator":"TEMPORAL_RANGE","comparator":"No - filter","expressionType":"SIMPLE"}],"row_limit":10000,"truncate_metric":true,"show_empty_columns":true,"rolling_type":null,"time_compare":null,"comparison_type":null,"annotation_layers":[],"forecastPeriods":10,"forecastInterval":0.8,"orientation":"vertical","x_axis_title_margin":15,"y_axis_title_margin":15,"y_axis_title_position":"Left","sort_series_type":"sum","color_scheme":"supersetColors","time_shift_color":true,"stack":"Stack","only_total":true,"show_legend":true,"legendType":"scroll","legendOrientation":"top","x_axis_time_format":"smart_date","y_axis_format":null,"y_axis_bounds":[null,null],"truncateXAxis":true,"rich_tooltip":true,"showTooltipTotal":true,"tooltipTimeFormat":"smart_date","extra_form_data":{},"dashboards":[9],"force":false,"result_format":"json","result_type":"full"},"result_format":"json","result_type":"full"}' -cache_timeout: null -uuid: 692aca26-a526-85db-c94c-411c91cc1077 -version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 diff --git a/superset/examples/configs/charts/Vehicle Sales/Quarterly_Sales_By_Product_Line_113.yaml b/superset/examples/configs/charts/Vehicle Sales/Quarterly_Sales_By_Product_Line_113.yaml deleted file mode 100644 index 46049fc1c0b..00000000000 --- a/superset/examples/configs/charts/Vehicle Sales/Quarterly_Sales_By_Product_Line_113.yaml +++ /dev/null @@ -1,103 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -slice_name: Quarterly Sales (By Product Line) -description: null -certified_by: null -certification_details: null -viz_type: echarts_timeseries_bar -params: - datasource: 21__table - viz_type: echarts_timeseries_bar - slice_id: 113 - x_axis: order_date - time_grain_sqla: P3M - metrics: - - aggregate: SUM - column: - column_name: sales - description: null - expression: null - filterable: true - groupby: true - id: 917 - is_dttm: false - optionName: _col_Sales - python_date_format: null - type: DOUBLE PRECISION - verbose_name: null - expressionType: SIMPLE - hasCustomLabel: false - isNew: false - label: SUM(Sales) - optionName: metric_tjn8bh6y44_7o4etwsqhal - sqlExpression: null - groupby: - - product_line - adhoc_filters: - - expressionType: SIMPLE - subject: order_date - operator: TEMPORAL_RANGE - comparator: No filter - clause: WHERE - sqlExpression: null - isExtra: false - isNew: false - datasourceWarning: false - filterOptionName: filter_skx80xwzof_2l0t7nomekl - order_desc: true - row_limit: 10000 - truncate_metric: true - show_empty_columns: true - rolling_type: null - time_compare: null - comparison_type: null - annotation_layers: [] - forecastPeriods: 10 - forecastInterval: 0.8 - orientation: vertical - x_axis_title_margin: 15 - y_axis_title_margin: 15 - y_axis_title_position: Left - sort_series_type: sum - color_scheme: supersetColors - time_shift_color: true - only_total: true - show_legend: true - legendType: scroll - legendOrientation: top - x_axis_time_format: smart_date - y_axis_format: null - y_axis_bounds: - - null - - null - truncateXAxis: true - rich_tooltip: true - showTooltipTotal: true - tooltipTimeFormat: smart_date - extra_form_data: {} - dashboards: - - 9 -query_context: '{"datasource":{"id":21,"type":"table"},"force":false,"queries":[{"filters":[{"col":"order_date","op":"TEMPORAL_RANGE","val":"No - filter"}],"extras":{"time_grain_sqla":"P3M","having":"","where":""},"applied_time_extras":{},"columns":[{"timeGrain":"P3M","columnType":"BASE_AXIS","sqlExpression":"order_date","label":"order_date","expressionType":"SQL"},"product_line"],"metrics":[{"aggregate":"SUM","column":{"column_name":"sales","description":null,"expression":null,"filterable":true,"groupby":true,"id":917,"is_dttm":false,"optionName":"_col_Sales","python_date_format":null,"type":"DOUBLE - PRECISION","verbose_name":null},"expressionType":"SIMPLE","hasCustomLabel":false,"isNew":false,"label":"SUM(Sales)","optionName":"metric_tjn8bh6y44_7o4etwsqhal","sqlExpression":null}],"orderby":[[{"aggregate":"SUM","column":{"column_name":"sales","description":null,"expression":null,"filterable":true,"groupby":true,"id":917,"is_dttm":false,"optionName":"_col_Sales","python_date_format":null,"type":"DOUBLE - PRECISION","verbose_name":null},"expressionType":"SIMPLE","hasCustomLabel":false,"isNew":false,"label":"SUM(Sales)","optionName":"metric_tjn8bh6y44_7o4etwsqhal","sqlExpression":null},false]],"annotation_layers":[],"row_limit":10000,"series_columns":["product_line"],"series_limit":0,"order_desc":true,"url_params":{},"custom_params":{},"custom_form_data":{},"time_offsets":[],"post_processing":[{"operation":"pivot","options":{"index":["order_date"],"columns":["product_line"],"aggregates":{"SUM(Sales)":{"operator":"mean"}},"drop_missing_columns":false}},{"operation":"rename","options":{"columns":{"SUM(Sales)":null},"level":0,"inplace":true}},{"operation":"flatten"}]}],"form_data":{"datasource":"21__table","viz_type":"echarts_timeseries_bar","slice_id":113,"x_axis":"order_date","time_grain_sqla":"P3M","metrics":[{"aggregate":"SUM","column":{"column_name":"sales","description":null,"expression":null,"filterable":true,"groupby":true,"id":917,"is_dttm":false,"optionName":"_col_Sales","python_date_format":null,"type":"DOUBLE - PRECISION","verbose_name":null},"expressionType":"SIMPLE","hasCustomLabel":false,"isNew":false,"label":"SUM(Sales)","optionName":"metric_tjn8bh6y44_7o4etwsqhal","sqlExpression":null}],"groupby":["product_line"],"adhoc_filters":[{"expressionType":"SIMPLE","subject":"order_date","operator":"TEMPORAL_RANGE","comparator":"No - filter","clause":"WHERE","sqlExpression":null,"isExtra":false,"isNew":false,"datasourceWarning":false,"filterOptionName":"filter_skx80xwzof_2l0t7nomekl"}],"order_desc":true,"row_limit":10000,"truncate_metric":true,"show_empty_columns":true,"rolling_type":null,"time_compare":null,"comparison_type":null,"annotation_layers":[],"forecastPeriods":10,"forecastInterval":0.8,"orientation":"vertical","x_axis_title_margin":15,"y_axis_title_margin":15,"y_axis_title_position":"Left","sort_series_type":"sum","color_scheme":"supersetColors","time_shift_color":true,"only_total":true,"show_legend":true,"legendType":"scroll","legendOrientation":"top","x_axis_time_format":"smart_date","y_axis_format":null,"y_axis_bounds":[null,null],"truncateXAxis":true,"rich_tooltip":true,"showTooltipTotal":true,"tooltipTimeFormat":"smart_date","extra_form_data":{},"dashboards":[9],"force":false,"result_format":"json","result_type":"full"},"result_format":"json","result_type":"full"}' -cache_timeout: null -uuid: db9609e4-9b78-4a32-87a7-4d9e19d51cd8 -version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 diff --git a/superset/examples/configs/charts/Vehicle Sales/Total_Revenue.yaml b/superset/examples/configs/charts/Vehicle Sales/Total_Revenue.yaml deleted file mode 100644 index 073e396ca93..00000000000 --- a/superset/examples/configs/charts/Vehicle Sales/Total_Revenue.yaml +++ /dev/null @@ -1,79 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -slice_name: Total Revenue -description: null -certified_by: null -certification_details: null -viz_type: big_number -params: - datasource: 21__table - viz_type: big_number - slice_id: 114 - x_axis: order_date - metric: - aggregate: SUM - column: - column_name: sales - description: null - expression: null - filterable: true - groupby: true - id: 917 - is_dttm: false - optionName: _col_Sales - python_date_format: null - type: DOUBLE PRECISION - verbose_name: null - expressionType: SIMPLE - hasCustomLabel: false - isNew: false - label: (Sales) - optionName: metric_twq59hf4ej_g70qjfmehsq - sqlExpression: null - adhoc_filters: - - clause: WHERE - comparator: No filter - expressionType: SIMPLE - operator: TEMPORAL_RANGE - subject: order_date - show_trend_line: true - start_y_axis_at_zero: true - color_picker: - a: 1 - b: 135 - g: 122 - r: 0 - header_font_size: 0.4 - subheader_font_size: 0.15 - y_axis_format: .3s - currency_format: - symbolPosition: prefix - symbol: USD - time_format: smart_date - rolling_type: cumsum - extra_form_data: {} - dashboards: - - 9 -query_context: '{"datasource":{"id":21,"type":"table"},"force":false,"queries":[{"filters":[{"col":"order_date","op":"TEMPORAL_RANGE","val":"No - filter"}],"extras":{"having":"","where":""},"applied_time_extras":{},"columns":[{"columnType":"BASE_AXIS","sqlExpression":"order_date","label":"order_date","expressionType":"SQL"}],"metrics":[{"aggregate":"SUM","column":{"column_name":"sales","description":null,"expression":null,"filterable":true,"groupby":true,"id":917,"is_dttm":false,"optionName":"_col_Sales","python_date_format":null,"type":"DOUBLE - PRECISION","verbose_name":null},"expressionType":"SIMPLE","hasCustomLabel":false,"isNew":false,"label":"(Sales)","optionName":"metric_twq59hf4ej_g70qjfmehsq","sqlExpression":null}],"annotation_layers":[],"series_limit":0,"order_desc":true,"url_params":{},"custom_params":{},"custom_form_data":{},"post_processing":[{"operation":"pivot","options":{"index":["order_date"],"columns":[],"aggregates":{"(Sales)":{"operator":"mean"}},"drop_missing_columns":true}},{"operation":"cum","options":{"operator":"sum","columns":{"(Sales)":"(Sales)"}}},{"operation":"flatten"}]}],"form_data":{"datasource":"21__table","viz_type":"big_number","slice_id":114,"x_axis":"order_date","metric":{"aggregate":"SUM","column":{"column_name":"sales","description":null,"expression":null,"filterable":true,"groupby":true,"id":917,"is_dttm":false,"optionName":"_col_Sales","python_date_format":null,"type":"DOUBLE - PRECISION","verbose_name":null},"expressionType":"SIMPLE","hasCustomLabel":false,"isNew":false,"label":"(Sales)","optionName":"metric_twq59hf4ej_g70qjfmehsq","sqlExpression":null},"adhoc_filters":[{"clause":"WHERE","comparator":"No - filter","expressionType":"SIMPLE","operator":"TEMPORAL_RANGE","subject":"order_date"}],"show_trend_line":true,"start_y_axis_at_zero":true,"color_picker":{"a":1,"b":135,"g":122,"r":0},"header_font_size":0.4,"subheader_font_size":0.15,"y_axis_format":".3s","currency_format":{"symbolPosition":"prefix","symbol":"USD"},"time_format":"smart_date","rolling_type":"cumsum","extra_form_data":{},"dashboards":[9],"force":false,"result_format":"json","result_type":"full"},"result_format":"json","result_type":"full"}' -cache_timeout: null -uuid: 7b12a243-88e0-4dc5-ac33-9a840bb0ac5a -version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 diff --git a/superset/examples/configs/charts/Video Game Sales/Games_per_Genre_over_time.yaml b/superset/examples/configs/charts/Video Game Sales/Games_per_Genre_over_time.yaml deleted file mode 100644 index d57f8f64c9e..00000000000 --- a/superset/examples/configs/charts/Video Game Sales/Games_per_Genre_over_time.yaml +++ /dev/null @@ -1,118 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -slice_name: Games per Genre over time -viz_type: echarts_timeseries_line -params: - adhoc_filters: [] - annotation_layers: [] - bottom_margin: auto - color_scheme: supersetColors - comparison_type: values - contribution: false - datasource: 21__table - granularity_sqla: year - groupby: - - genre - label_colors: - "0": "#1FA8C9" - "1": "#454E7C" - "2600": "#666666" - 3DO: "#B2B2B2" - 3DS: "#D1C6BC" - Action: "#1FA8C9" - Adventure: "#454E7C" - DC: "#A38F79" - DS: "#8FD3E4" - Europe: "#5AC189" - Fighting: "#5AC189" - GB: "#FDE380" - GBA: "#ACE1C4" - GC: "#5AC189" - GEN: "#3CCCCB" - GG: "#EFA1AA" - Japan: "#FF7F44" - Microsoft Game Studios: "#D1C6BC" - Misc: "#FF7F44" - N64: "#1FA8C9" - NES: "#9EE5E5" - NG: "#A1A6BD" - Nintendo: "#D3B3DA" - North America: "#666666" - Other: "#E04355" - PC: "#EFA1AA" - PCFX: "#FDE380" - PS: "#A1A6BD" - PS2: "#FCC700" - PS3: "#3CCCCB" - PS4: "#B2B2B2" - PSP: "#FEC0A1" - PSV: "#FCC700" - Platform: "#666666" - Puzzle: "#E04355" - Racing: "#FCC700" - Role-Playing: "#A868B7" - SAT: "#A868B7" - SCD: "#8FD3E4" - SNES: "#454E7C" - Shooter: "#3CCCCB" - Simulation: "#A38F79" - Sports: "#8FD3E4" - Strategy: "#A1A6BD" - TG16: "#FEC0A1" - Take-Two Interactive: "#9EE5E5" - WS: "#ACE1C4" - Wii: "#A38F79" - WiiU: "#E04355" - X360: "#A868B7" - XB: "#D3B3DA" - XOne: "#FF7F44" - left_margin: auto - line_interpolation: linear - metrics: - - count - order_desc: true - queryFields: - groupby: groupby - metrics: metrics - rich_tooltip: true - rolling_type: None - row_limit: null - show_brush: auto - show_legend: true - show_markers: false - slice_id: 3544 - time_grain_sqla: null - time_range: No filter - url_params: - preselect_filters: - '{"1389": {"platform": ["PS", "PS2", "PS3", "PS4"], "genre": - null, "__time_range": "No filter"}}' - viz_type: echarts_timeseries_line - x_axis_format: smart_date - x_axis_label: Year Published - x_axis_showminmax: true - x_ticks_layout: auto - y_axis_bounds: - - null - - null - y_axis_format: SMART_NUMBER - y_axis_label: "# of Games Published" - y_axis_showminmax: true -cache_timeout: null -uuid: 0f8976aa-7bb4-40c7-860b-64445a51aaaf -version: 1.0.0 -dataset_uuid: 53d47c0c-c03d-47f0-b9ac-81225f808283 diff --git a/superset/examples/configs/charts/Video Game Sales/Rise__Fall_of_Video_Game_Consoles.yaml b/superset/examples/configs/charts/Video Game Sales/Rise__Fall_of_Video_Game_Consoles.yaml deleted file mode 100644 index b370ba6db56..00000000000 --- a/superset/examples/configs/charts/Video Game Sales/Rise__Fall_of_Video_Game_Consoles.yaml +++ /dev/null @@ -1,133 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -slice_name: Rise & Fall of Video Game Consoles -viz_type: echarts_area -params: - adhoc_filters: [] - annotation_layers: [] - bottom_margin: auto - color_scheme: supersetColors - comparison_type: values - contribution: false - datasource: 21__table - granularity_sqla: year - groupby: - - platform - label_colors: - "0": "#1FA8C9" - "1": "#454E7C" - "2600": "#666666" - 3DO: "#B2B2B2" - 3DS: "#D1C6BC" - Action: "#1FA8C9" - Adventure: "#454E7C" - DC: "#A38F79" - DS: "#8FD3E4" - Europe: "#5AC189" - Fighting: "#5AC189" - GB: "#FDE380" - GBA: "#ACE1C4" - GC: "#5AC189" - GEN: "#3CCCCB" - GG: "#EFA1AA" - Japan: "#FF7F44" - Microsoft Game Studios: "#D1C6BC" - Misc: "#FF7F44" - N64: "#1FA8C9" - NES: "#9EE5E5" - NG: "#A1A6BD" - Nintendo: "#D3B3DA" - North America: "#666666" - Other: "#E04355" - PC: "#EFA1AA" - PCFX: "#FDE380" - PS: "#A1A6BD" - PS2: "#FCC700" - PS3: "#3CCCCB" - PS4: "#B2B2B2" - PSP: "#FEC0A1" - PSV: "#FCC700" - Platform: "#666666" - Puzzle: "#E04355" - Racing: "#FCC700" - Role-Playing: "#A868B7" - SAT: "#A868B7" - SCD: "#8FD3E4" - SNES: "#454E7C" - Shooter: "#3CCCCB" - Simulation: "#A38F79" - Sports: "#8FD3E4" - Strategy: "#A1A6BD" - TG16: "#FEC0A1" - Take-Two Interactive: "#9EE5E5" - WS: "#ACE1C4" - Wii: "#A38F79" - WiiU: "#E04355" - X360: "#A868B7" - XB: "#D3B3DA" - XOne: "#FF7F44" - line_interpolation: linear - metrics: - - aggregate: SUM - column: - column_name: global_sales - description: null - expression: null - filterable: true - groupby: true - id: 887 - is_dttm: false - optionName: _col_Global_Sales - python_date_format: null - type: DOUBLE PRECISION - verbose_name: null - expressionType: SIMPLE - hasCustomLabel: false - isNew: false - label: SUM(Global_Sales) - optionName: metric_ufl75addr8c_oqqhdumirpn - sqlExpression: null - order_desc: true - queryFields: - groupby: groupby - metrics: metrics - rich_tooltip: true - rolling_type: None - row_limit: null - show_brush: auto - show_legend: false - slice_id: 659 - stacked_style: stream - time_grain_sqla: null - time_range: No filter - url_params: - preselect_filters: - '{"1389": {"platform": ["PS", "PS2", "PS3", "PS4"], "genre": - null, "__time_range": "No filter"}}' - viz_type: echarts_area - x_axis_format: smart_date - x_axis_label: Year Published - x_axis_showminmax: true - x_ticks_layout: auto - y_axis_bounds: - - null - - null - y_axis_format: SMART_NUMBER -cache_timeout: null -uuid: 83b0e2d0-d38b-d980-ed8e-e1c9846361b6 -version: 1.0.0 -dataset_uuid: 53d47c0c-c03d-47f0-b9ac-81225f808283 diff --git a/superset/examples/configs/charts/Video Game Sales/Top_10_Games_Proportion_of_Sales_in_Markets.yaml b/superset/examples/configs/charts/Video Game Sales/Top_10_Games_Proportion_of_Sales_in_Markets.yaml deleted file mode 100644 index 344122d25d3..00000000000 --- a/superset/examples/configs/charts/Video Game Sales/Top_10_Games_Proportion_of_Sales_in_Markets.yaml +++ /dev/null @@ -1,132 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -slice_name: "Top 10 Games: Proportion of Sales in Markets" -viz_type: echarts_timeseries_bar -params: - adhoc_filters: - - clause: WHERE - comparator: "10" - expressionType: SIMPLE - filterOptionName: filter_juemdnqji5_d6fm8tuf4rc - isExtra: false - isNew: false - operator: <= - sqlExpression: null - subject: rank - bar_stacked: true - bottom_margin: auto - color_scheme: supersetColors - columns: [] - contribution: true - datasource: 21__table - granularity_sqla: year - groupby: - - name - label_colors: {} - metrics: - - aggregate: SUM - column: - column_name: na_sales - description: null - expression: null - filterable: true - groupby: true - id: 883 - is_dttm: false - optionName: _col_NA_Sales - python_date_format: null - type: DOUBLE PRECISION - verbose_name: null - expressionType: SIMPLE - hasCustomLabel: true - isNew: false - label: North America - optionName: metric_a943v7wg5g_0mm03hrsmpf - sqlExpression: null - - aggregate: SUM - column: - column_name: eu_sales - description: null - expression: null - filterable: true - groupby: true - id: 884 - is_dttm: false - optionName: _col_EU_Sales - python_date_format: null - type: DOUBLE PRECISION - verbose_name: null - expressionType: SIMPLE - hasCustomLabel: true - isNew: false - label: Europe - optionName: metric_bibau54x0rb_dwrjtqkbyso - sqlExpression: null - - aggregate: SUM - column: - column_name: jp_sales - description: null - expression: null - filterable: true - groupby: true - id: 885 - is_dttm: false - optionName: _col_JP_Sales - python_date_format: null - type: DOUBLE PRECISION - verbose_name: null - expressionType: SIMPLE - hasCustomLabel: true - isNew: false - label: Japan - optionName: metric_06whpr2oyhw_4l88xxu6zvd - sqlExpression: null - - aggregate: SUM - column: - column_name: other_sales - description: null - expression: null - filterable: true - groupby: true - id: 886 - is_dttm: false - optionName: _col_Other_Sales - python_date_format: null - type: DOUBLE PRECISION - verbose_name: null - expressionType: SIMPLE - hasCustomLabel: true - isNew: false - label: Other - optionName: metric_pcx05ioxums_ibr16zvi74 - sqlExpression: null - queryFields: - columns: groupby - groupby: groupby - metrics: metrics - row_limit: null - show_legend: true - slice_id: 3546 - time_range: No filter - url_params: {} - viz_type: echarts_timeseries_bar - x_ticks_layout: staggered - y_axis_format: SMART_NUMBER -cache_timeout: null -uuid: a40879d5-653a-42fe-9314-bbe88ad26e92 -version: 1.0.0 -dataset_uuid: 53d47c0c-c03d-47f0-b9ac-81225f808283 diff --git a/superset/examples/configs/charts/Video Game Sales/Total_Sales_per_Market_Grouped_by_Genre.yaml b/superset/examples/configs/charts/Video Game Sales/Total_Sales_per_Market_Grouped_by_Genre.yaml deleted file mode 100644 index 78ddf4bbeca..00000000000 --- a/superset/examples/configs/charts/Video Game Sales/Total_Sales_per_Market_Grouped_by_Genre.yaml +++ /dev/null @@ -1,182 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -slice_name: Total Sales per Market (Grouped by Genre) -viz_type: echarts_timeseries_bar -params: - adhoc_filters: [] - bar_stacked: true - bottom_margin: auto - color_scheme: supersetColors - columns: [] - contribution: false - datasource: 21__table - granularity_sqla: year - groupby: - - genre - label_colors: - "0": "#1FA8C9" - "1": "#454E7C" - "2600": "#666666" - 3DO: "#B2B2B2" - 3DS: "#D1C6BC" - Action: "#1FA8C9" - Adventure: "#454E7C" - DC: "#A38F79" - DS: "#8FD3E4" - Europe: "#5AC189" - Fighting: "#5AC189" - GB: "#FDE380" - GBA: "#ACE1C4" - GC: "#5AC189" - GEN: "#3CCCCB" - GG: "#EFA1AA" - Japan: "#FF7F44" - Microsoft Game Studios: "#D1C6BC" - Misc: "#FF7F44" - N64: "#1FA8C9" - NES: "#9EE5E5" - NG: "#A1A6BD" - Nintendo: "#D3B3DA" - North America: "#666666" - Other: "#E04355" - PC: "#EFA1AA" - PCFX: "#FDE380" - PS: "#A1A6BD" - PS2: "#FCC700" - PS3: "#3CCCCB" - PS4: "#B2B2B2" - PSP: "#FEC0A1" - PSV: "#FCC700" - Platform: "#666666" - Puzzle: "#E04355" - Racing: "#FCC700" - Role-Playing: "#A868B7" - SAT: "#A868B7" - SCD: "#8FD3E4" - SNES: "#454E7C" - Shooter: "#3CCCCB" - Simulation: "#A38F79" - Sports: "#8FD3E4" - Strategy: "#A1A6BD" - TG16: "#FEC0A1" - Take-Two Interactive: "#9EE5E5" - WS: "#ACE1C4" - Wii: "#A38F79" - WiiU: "#E04355" - X360: "#A868B7" - XB: "#D3B3DA" - XOne: "#FF7F44" - metrics: - - aggregate: SUM - column: - column_name: na_sales - description: null - expression: null - filterable: true - groupby: true - id: 883 - is_dttm: false - optionName: _col_NA_Sales - python_date_format: null - type: DOUBLE PRECISION - verbose_name: null - expressionType: SIMPLE - hasCustomLabel: true - isNew: false - label: North America - optionName: metric_3pl6jwmyd72_p9o4j2xxgyp - sqlExpression: null - - aggregate: SUM - column: - column_name: eu_sales - description: null - expression: null - filterable: true - groupby: true - id: 884 - is_dttm: false - optionName: _col_EU_Sales - python_date_format: null - type: DOUBLE PRECISION - verbose_name: null - expressionType: SIMPLE - hasCustomLabel: true - isNew: false - label: Europe - optionName: metric_e8rdyfxxjdu_6dgyhf7xcne - sqlExpression: null - - aggregate: SUM - column: - column_name: jp_sales - description: null - expression: null - filterable: true - groupby: true - id: 885 - is_dttm: false - optionName: _col_JP_Sales - python_date_format: null - type: DOUBLE PRECISION - verbose_name: null - expressionType: SIMPLE - hasCustomLabel: true - isNew: false - label: Japan - optionName: metric_6gesefugzy6_517l3wowdwu - sqlExpression: null - - aggregate: SUM - column: - column_name: other_sales - description: null - expression: null - filterable: true - groupby: true - id: 886 - is_dttm: false - optionName: _col_Other_Sales - python_date_format: null - type: DOUBLE PRECISION - verbose_name: null - expressionType: SIMPLE - hasCustomLabel: true - isNew: false - label: Other - optionName: metric_cf6kbre28f_2sg5b5pfq5a - sqlExpression: null - order_bars: false - queryFields: - columns: groupby - groupby: groupby - metrics: metrics - row_limit: null - show_bar_value: false - show_controls: true - show_legend: true - slice_id: 3548 - time_range: No filter - url_params: - preselect_filters: - '{"1389": {"platform": ["PS", "PS2", "PS3", "PS4"], "genre": - null, "__time_range": "No filter"}}' - viz_type: echarts_timeseries_bar - x_axis_label: Genre - x_ticks_layout: flat - y_axis_format: SMART_NUMBER -cache_timeout: null -uuid: d8bf948e-46fd-4380-9f9c-a950c34bcc92 -version: 1.0.0 -dataset_uuid: 53d47c0c-c03d-47f0-b9ac-81225f808283 diff --git a/superset/examples/configs/dashboards/COVID_Vaccine_Dashboard.yaml b/superset/examples/configs/dashboards/COVID_Vaccine_Dashboard.yaml deleted file mode 100644 index fbaf0b16d3f..00000000000 --- a/superset/examples/configs/dashboards/COVID_Vaccine_Dashboard.yaml +++ /dev/null @@ -1,399 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -dashboard_title: COVID Vaccine Dashboard -description: null -css: "" -slug: null -certified_by: "" -certification_details: "" -published: true -uuid: f4065089-110a-41fa-8dd7-9ce98a65e250 -position: - CHART-63bEuxjDMJ: - children: [] - id: CHART-63bEuxjDMJ - meta: - chartId: 3961 - height: 60 - sliceName: Vaccine Candidates per Country - sliceNameOverride: Map of Vaccine Candidates - uuid: ddc91df6-fb40-4826-bdca-16b85af1c024 - width: 8 - parents: - - ROOT_ID - - TABS-wUKya7eQ0Z - - TAB-BCIJF4NvgQ - - ROW-xSeNAspgw - type: CHART - CHART-F-fkth0Dnv: - children: [] - id: CHART-F-fkth0Dnv - meta: - chartId: 3960 - height: 82 - sliceName: Vaccine Candidates per Country - sliceNameOverride: Treemap of Vaccine Candidates per Country - uuid: e2f5a8a7-feb0-4f79-bc6b-01fe55b98b3c - width: 4 - parents: - - ROOT_ID - - TABS-wUKya7eQ0Z - - TAB-BCIJF4NvgQ - - ROW-dieUdkeUw - type: CHART - CHART-RjD_ygqtwH: - children: [] - id: CHART-RjD_ygqtwH - meta: - chartId: 3957 - height: 72 - sliceName: Vaccine Candidates per Phase - sliceNameOverride: Vaccine Candidates per Phase - uuid: 30b73c65-85e7-455f-bb24-801bb0cdc670 - width: 3 - parents: - - ROOT_ID - - TABS-wUKya7eQ0Z - - TAB-BCIJF4NvgQ - - ROW-zhOlQLQnB - type: CHART - CHART-aGfmWtliqA: - children: [] - id: CHART-aGfmWtliqA - meta: - chartId: 3956 - height: 72 - sliceName: Vaccine Candidates per Phase - uuid: 392f293e-0892-4316-bd41-c927b65606a4 - width: 5 - parents: - - ROOT_ID - - TABS-wUKya7eQ0Z - - TAB-BCIJF4NvgQ - - ROW-zhOlQLQnB - type: CHART - CHART-dCUpAcPsji: - children: [] - id: CHART-dCUpAcPsji - meta: - chartId: 3963 - height: 82 - sliceName: Vaccine Candidates per Country & Stage - sliceNameOverride: Heatmap of Countries & Clinical Stages - uuid: cd111331-d286-4258-9020-c7949a109ed2 - width: 4 - parents: - - ROOT_ID - - TABS-wUKya7eQ0Z - - TAB-BCIJF4NvgQ - - ROW-dieUdkeUw - type: CHART - CHART-fYo7IyvKZQ: - children: [] - id: CHART-fYo7IyvKZQ - meta: - chartId: 3964 - height: 60 - sliceName: Vaccine Candidates per Country & Stage - sliceNameOverride: Sunburst of Country & Clinical Stages - uuid: f69c556f-15fe-4a82-a8bb-69d5b6954123 - width: 4 - parents: - - ROOT_ID - - TABS-wUKya7eQ0Z - - TAB-BCIJF4NvgQ - - ROW-xSeNAspgw - type: CHART - CHART-j4hUvP5dDD: - children: [] - id: CHART-j4hUvP5dDD - meta: - chartId: 3962 - height: 82 - sliceName: Vaccine Candidates per Approach & Stage - sliceNameOverride: Heatmap of Approaches & Clinical Stages - uuid: 0c953c84-0c9a-418d-be9f-2894d2a2cee0 - width: 4 - parents: - - ROOT_ID - - TABS-wUKya7eQ0Z - - TAB-BCIJF4NvgQ - - ROW-dieUdkeUw - type: CHART - DASHBOARD_VERSION_KEY: v2 - GRID_ID: - children: [] - id: GRID_ID - parents: - - ROOT_ID - type: GRID - HEADER_ID: - id: HEADER_ID - meta: - text: COVID Vaccine Dashboard - type: HEADER - MARKDOWN-VjQQ5SFj5v: - children: [] - id: MARKDOWN-VjQQ5SFj5v - meta: - code: "# COVID-19 Vaccine Dashboard - - - Everywhere you look, you see negative news about COVID-19. This is to be expected; - it''s been a brutal year and this disease is no joke. This dashboard hopes - to use visualization to inject some optimism about the coming return to normalcy - we enjoyed before 2020! There''s lots to be optimistic about: - - - - the sheer volume of attempts to fund the R&D needed to produce and bring - an effective vaccine to market - - - the large number of countries involved in at least one vaccine candidate - (and the diversity of economic status of these countries) - - - the diversity of vaccine approaches taken - - - the fact that 2 vaccines have already been approved (and a hundreds of thousands - of patients have already been vaccinated) - - - ### The Dataset - - - This dashboard is powered by data maintained by the Millken Institute ([link - to dataset](https://airtable.com/shrSAi6t5WFwqo3GM/tblEzPQS5fnc0FHYR/viwDBH7b6FjmIBX5x?blocks=bipZFzhJ7wHPv7x9z)). - We researched each vaccine candidate and added our own best guesses for the - country responsible for each vaccine effort. - - - _Note that this dataset was last updated on 07/2021_. - - - " - height: 72 - width: 4 - parents: - - ROOT_ID - - TABS-wUKya7eQ0Z - - TAB-BCIJF4NvgQ - - ROW-zhOlQLQnB - type: MARKDOWN - ROOT_ID: - children: - - TABS-wUKya7eQ0Z - id: ROOT_ID - type: ROOT - ROW-dieUdkeUw: - children: - - CHART-F-fkth0Dnv - - CHART-dCUpAcPsji - - CHART-j4hUvP5dDD - id: ROW-dieUdkeUw - meta: - "0": ROOT_ID - background: BACKGROUND_TRANSPARENT - parents: - - ROOT_ID - - TABS-wUKya7eQ0Z - - TAB-BCIJF4NvgQ - type: ROW - ROW-xSeNAspgw: - children: - - CHART-63bEuxjDMJ - - CHART-fYo7IyvKZQ - id: ROW-xSeNAspgw - meta: - "0": ROOT_ID - background: BACKGROUND_TRANSPARENT - parents: - - ROOT_ID - - TABS-wUKya7eQ0Z - - TAB-BCIJF4NvgQ - type: ROW - ROW-zhOlQLQnB: - children: - - MARKDOWN-VjQQ5SFj5v - - CHART-RjD_ygqtwH - - CHART-aGfmWtliqA - id: ROW-zhOlQLQnB - meta: - "0": ROOT_ID - background: BACKGROUND_TRANSPARENT - parents: - - ROOT_ID - - TABS-wUKya7eQ0Z - - TAB-BCIJF4NvgQ - type: ROW - TAB-BCIJF4NvgQ: - children: - - ROW-zhOlQLQnB - - ROW-xSeNAspgw - - ROW-dieUdkeUw - id: TAB-BCIJF4NvgQ - meta: - text: Overview - parents: - - ROOT_ID - - TABS-wUKya7eQ0Z - type: TAB - TABS-wUKya7eQ0Z: - children: - - TAB-BCIJF4NvgQ - id: TABS-wUKya7eQ0Z - meta: {} - parents: - - ROOT_ID - type: TABS -metadata: - timed_refresh_immune_slices: [] - expanded_slices: {} - refresh_frequency: 0 - default_filters: "{}" - native_filter_configuration: - - id: NATIVE_FILTER-8jS1fx4hl - controlValues: - enableEmptyFilter: false - defaultToFirstItem: false - multiSelect: true - searchAllOptions: false - inverseSelection: false - name: Country - filterType: filter_select - targets: - - column: - name: country_name - datasetUuid: 974b7a1c-22ea-49cb-9214-97b7dbd511e0 - defaultDataMask: - extraFormData: {} - filterState: {} - ownState: {} - cascadeParentIds: [] - scope: - rootPath: - - ROOT_ID - excluded: [] - type: NATIVE_FILTER - description: '' - chartsInScope: - - 9 - - 10 - - 11 - - 12 - - 13 - - 14 - - 15 - - 66 - tabsInScope: - - TAB-BCIJF4NvgQ - - id: NATIVE_FILTER-3_1wEdKkP - controlValues: - enableEmptyFilter: false - defaultToFirstItem: false - multiSelect: true - searchAllOptions: false - inverseSelection: false - name: Vaccine Approach - filterType: filter_select - targets: - - column: - name: product_category - datasetUuid: 974b7a1c-22ea-49cb-9214-97b7dbd511e0 - defaultDataMask: - extraFormData: {} - filterState: {} - ownState: {} - cascadeParentIds: [] - scope: - rootPath: - - ROOT_ID - excluded: [] - type: NATIVE_FILTER - description: '' - chartsInScope: - - 9 - - 10 - - 11 - - 12 - - 13 - - 14 - - 15 - - 66 - tabsInScope: - - TAB-BCIJF4NvgQ - - id: NATIVE_FILTER-EWNH3M70z - controlValues: - enableEmptyFilter: false - defaultToFirstItem: false - multiSelect: true - searchAllOptions: false - inverseSelection: false - name: Clinical Stage - filterType: filter_select - targets: - - column: - name: clinical_stage - datasetUuid: 974b7a1c-22ea-49cb-9214-97b7dbd511e0 - defaultDataMask: - extraFormData: {} - filterState: {} - ownState: {} - cascadeParentIds: [] - scope: - rootPath: - - ROOT_ID - excluded: [] - type: NATIVE_FILTER - description: '' - chartsInScope: - - 9 - - 10 - - 11 - - 12 - - 13 - - 14 - - 15 - - 66 - tabsInScope: - - TAB-BCIJF4NvgQ - color_scheme: supersetColors - label_colors: - "0": "#D3B3DA" - "1": "#9EE5E5" - 0. Pre-clinical: "#1FA8C9" - 2. Phase II or Combined I/II: "#454E7C" - 1. Phase I: "#5AC189" - 3. Phase III: "#FF7F44" - 4. Authorized: "#666666" - root: "#1FA8C9" - Protein subunit: "#454E7C" - Phase II: "#5AC189" - Pre-clinical: "#FF7F44" - Phase III: "#666666" - Phase I: "#E04355" - Phase I/II: "#FCC700" - Inactivated virus: "#A868B7" - Virus-like particle: "#3CCCCB" - Replicating bacterial vector: "#A38F79" - DNA-based: "#8FD3E4" - RNA-based vaccine: "#A1A6BD" - Authorized: "#ACE1C4" - Non-replicating viral vector: "#FEC0A1" - Replicating viral vector: "#B2B2B2" - Unknown: "#EFA1AA" - Live attenuated virus: "#FDE380" - COUNT(*): "#D1C6BC" -version: 1.0.0 diff --git a/superset/examples/configs/dashboards/Unicode_Test.test.yaml b/superset/examples/configs/dashboards/Unicode_Test.test.yaml deleted file mode 100644 index f14923a4d14..00000000000 --- a/superset/examples/configs/dashboards/Unicode_Test.test.yaml +++ /dev/null @@ -1,52 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -dashboard_title: Unicode Test -description: null -css: null -slug: unicode-test -uuid: 6b2de44e-7db1-4264-bfc1-ac3c00d42fad -position: - CHART-Hkx6154FEm: - children: [] - id: CHART-Hkx6154FEm - meta: - chartId: 389 - height: 30 - sliceName: slice 1 - width: 4 - uuid: 609e26d8-8e1e-4097-9751-931708e24ee4 - type: CHART - GRID_ID: - children: - - ROW-SyT19EFEQ - id: GRID_ID - type: GRID - ROOT_ID: - children: - - GRID_ID - id: ROOT_ID - type: ROOT - ROW-SyT19EFEQ: - children: - - CHART-Hkx6154FEm - id: ROW-SyT19EFEQ - meta: - background: BACKGROUND_TRANSPARENT - type: ROW - DASHBOARD_VERSION_KEY: v2 -metadata: {} -version: 1.0.0 diff --git a/superset/examples/configs/datasets/examples/FCC_2018_Survey.yaml b/superset/examples/configs/datasets/examples/FCC_2018_Survey.yaml deleted file mode 100644 index 0943c947f31..00000000000 --- a/superset/examples/configs/datasets/examples/FCC_2018_Survey.yaml +++ /dev/null @@ -1,1493 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -table_name: FCC 2018 Survey -main_dttm_col: null -description: null -default_endpoint: null -offset: 0 -cache_timeout: null -schema: null -sql: "" -params: null -template_params: null -filter_select_enabled: true -fetch_values_predicate: null -extra: null -uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 -metrics: - - metric_name: count - verbose_name: COUNT(*) - metric_type: null - expression: COUNT(*) - description: null - d3format: null - extra: null - warning_text: null -columns: - - column_name: highest_degree_earned - verbose_name: Highest Degree Earned - is_dttm: false - is_active: null - type: STRING - groupby: true - filterable: true - expression: - "CASE \n WHEN school_degree = 'no high school (secondary school)'\ - \ THEN 'A. No high school (secondary school)'\n WHEN school_degree = 'some\ - \ high school' THEN 'B. Some high school'\n WHEN school_degree = 'high school\ - \ diploma or equivalent (GED)' THEN 'C. High school diploma or equivalent (GED)'\ - \n WHEN school_degree = 'associate''s degree' THEN 'D. Associate''s degree'\ - \n WHEN school_degree = 'some college credit, no degree' THEN 'E. Some college\ - \ credit, no degree'\n WHEN school_degree = 'bachelor''s degree' THEN 'F.\ - \ Bachelor''s degree'\n WHEN school_degree = 'trade, technical, or vocational\ - \ training' THEN 'G. Trade, technical, or vocational training'\n WHEN school_degree\ - \ = 'master''s degree (non-professional)' THEN 'H. Master''s degree (non-professional)'\ - \n WHEN school_degree = 'Ph.D.' THEN 'I. Ph.D.'\n WHEN school_degree = '\ - professional degree (MBA, MD, JD, etc.)' THEN 'J. Professional degree (MBA,\ - \ MD, JD, etc.)'\nEND" - description: Highest Degree Earned - python_date_format: null - - column_name: job_location_preference - verbose_name: Job Location Preference - is_dttm: false - is_active: null - type: null - groupby: true - filterable: true - expression: - "case \nwhen job_lctn_pref is Null then 'No Answer' \nwhen job_lctn_pref\ - \ = 'from home' then 'From Home'\nwhen job_lctn_pref = 'no preference' then 'No\ - \ Preference'\nwhen job_lctn_pref = 'in an office with other developers' then\ - \ 'In an Office (with Other Developers)'\nelse job_lctn_pref\nend " - description: null - python_date_format: null - - column_name: ethnic_minority - verbose_name: Ethnic Minority - is_dttm: null - is_active: null - type: STRING - groupby: true - filterable: true - expression: - "CASE \nWHEN is_ethnic_minority = 0 THEN 'No, not an ethnic minority'\ - \ \nWHEN is_ethnic_minority = 1 THEN 'Yes, an ethnic minority' \nELSE 'No Answer'\n\ - END" - description: null - python_date_format: null - - column_name: willing_to_relocate - verbose_name: Willing To Relocate - is_dttm: false - is_active: null - type: STRING - groupby: true - filterable: true - expression: - "CASE \nWHEN job_relocate = 0 THEN 'No: Not Willing to' \nWHEN job_relocate\ - \ = 1 THEN 'Yes: Willing To'\nELSE 'No Answer'\nEND" - description: null - python_date_format: null - - column_name: developer_type - verbose_name: Developer Type - is_dttm: false - is_active: null - type: STRING - groupby: true - filterable: true - expression: - CASE WHEN is_software_dev = 0 THEN 'Aspiring Developer' WHEN is_software_dev - = 1 THEN 'Currently A Developer' END - description: null - python_date_format: null - - column_name: first_time_developer - verbose_name: First Time Developer - is_dttm: false - is_active: null - type: null - groupby: true - filterable: true - expression: - "CASE \nWHEN is_first_dev_job = 0 THEN 'No' \nWHEN is_first_dev_job\ - \ = 1 THEN 'Yes' \nELSE 'No Answer'\nEND" - description: null - python_date_format: null - - column_name: gender - verbose_name: null - is_dttm: null - is_active: null - type: STRING - groupby: true - filterable: true - expression: - "CASE \nWHEN gender = 'Male' THEN 'Male'\nWHEN gender = 'Female' THEN\ - \ 'Female'\nELSE 'Prefer Not to Say'\nEND" - description: null - python_date_format: null - - column_name: calc_first_time_dev - verbose_name: null - is_dttm: false - is_active: null - type: STRING - groupby: true - filterable: true - expression: - CASE WHEN is_first_dev_job = 0 THEN 'No' WHEN is_first_dev_job = 1 THEN - 'Yes' END - description: null - python_date_format: null - - column_name: yt_codingtuts360 - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: is_recv_disab_bnft - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: job_intr_qa_engn - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: has_high_spd_ntnet - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: is_first_dev_job - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: job_intr_ux_engn - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: bootcamp_have_loan - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: podcast_js_jabber - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: job_intr_datasci - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: job_intr_dataengn - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: rsrc_khan_acdm - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: has_finance_depends - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: has_served_military - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: job_intr_backend - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: job_intr_teacher - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: months_job_search - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: student_debt_has - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: student_debt_amt - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: job_intr_gamedev - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: rsrc_code_wars - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: do_finance_support - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: last_yr_income - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: is_software_dev - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: money_for_learning - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: home_mrtg_has - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: job_intr_mobile - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: job_intr_infosec - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: job_intr_fllstck - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: job_intr_frntend - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: job_intr_devops - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: job_intr_projm - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: rsrc_css_tricks - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: yt_cs_dojo - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: is_ethnic_minority - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: yt_mit_ocw - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: is_self_employed - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: home_mrtg_owe - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: yt_engn_truth - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: bootcamp_attend - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: yt_derekbanas - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: yt_learncodeacdm - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: podcast_changelog - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: rsrc_hackerrank - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: podcast_devtea - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: podcast_sedaily - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: podcast_seradio - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: codeevnt_gamejam - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: podcast_geekspeak - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: podcast_talkpythonme - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: podcast_hanselmnts - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: podcast_syntaxfm - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: podcast_shoptalk - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: yt_mozillahacks - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: podcast_codingblcks - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: podcast_codenewbie - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: bootcamp_recommend - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: codeevnt_railsbrdg - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: bootcamp_finished - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: podcast_rubyrogues - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: job_relocate - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: debt_amt - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: rsrc_codeacdm - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: podcast_fcc - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: podcast_codepenrd - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: podcast_fullstckrd - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: codeevnt_hackthn - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: rsrc_udacity - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: podcast_ltcwm - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: rsrc_coursera - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: codeevnt_djangogrls - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: codeevnt_startupwknd - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: podcast_progthrwdwn - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: expected_earn - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: rsrc_egghead - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: codeevnt_railsgrls - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: has_children - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: podcast_frnthppyhr - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: yt_codingtrain - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: rsrc_lynda - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: hours_learning - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: yt_simplilearn - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: codeevnt_wkndbtcmp - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: codeevnt_fcc - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: rsrc_fcc - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: codeevnt_coderdojo - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: codeevnt_nodeschl - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: codeevnt_womenwc - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: codeevnt_confs - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: yt_fcc - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: codeevnt_girldevit - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: codeevnt_meetup - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: codeevnt_workshps - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: rsrc_frntendmstr - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: num_children - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: rsrc_udemy - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: rsrc_edx - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: rsrc_mdn - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: rsrc_treehouse - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: yt_computerphile - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: yt_funfunfunct - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: rsrc_so - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: yt_googledevs - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: yt_devtips - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: yt_simpleprog - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: yt_lvluptuts - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: time_start - verbose_name: null - is_dttm: true - is_active: null - type: DATETIME - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: time_total_sec - verbose_name: null - is_dttm: false - is_active: null - type: BIGINT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: months_programming - verbose_name: null - is_dttm: false - is_active: null - type: BIGINT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: age - verbose_name: null - is_dttm: false - is_active: null - type: BIGINT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: ID - verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: reasons_to_code_other - verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: lang_at_home - verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: when_appl_job - verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: reasons_to_code - verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: live_city_population - verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: job_lctn_pref - verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: job_intr_other - verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: marital_status - verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: bootcamp_name - verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: podcast_other - verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: school_major - verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: job_pref - verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: country_citizen - verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: school_degree - verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: codeevnt_other - verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: curr_field - verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: communite_time - verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: rsrc_other - verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: country_live - verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: gender_other - verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: time_end - verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: network_id - verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: yt_other - verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: gender - verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -version: 1.0.0 -database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee -data: examples://datasets/examples/fcc_survey_2018.csv.gz diff --git a/superset/examples/configs/datasets/examples/hierarchical_dataset.yaml b/superset/examples/configs/datasets/examples/hierarchical_dataset.yaml deleted file mode 100644 index 6f27506fb20..00000000000 --- a/superset/examples/configs/datasets/examples/hierarchical_dataset.yaml +++ /dev/null @@ -1,116 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -table_name: hierarchical_dataset -main_dttm_col: null -description: null -default_endpoint: null -offset: 0 -cache_timeout: null -schema: public -sql: 'SELECT 1 as "id", null as "parent", ''USA'' as "name", 1 as "count" - - UNION SELECT 2, 1, ''CA'', 10 - - UNION SELECT 3, 1, ''NY'', 15 - - UNION SELECT 4, 1, ''TX'', 20 - - UNION SELECT 5, 1, ''FL'', 12 - - UNION SELECT 6, 2, ''Los Angeles'', 5 - - UNION SELECT 7, 2, ''San Francisco'', 8 - - UNION SELECT 8, 3, ''New York City'', 18 - - UNION SELECT 9, 3, ''Buffalo'', 3 - - UNION SELECT 10, 4, ''Houston'', 14 - - UNION SELECT 11, 4, ''Dallas'', 9 - - UNION SELECT 12, 5, ''Miami'', 6' -params: null -template_params: null -filter_select_enabled: true -fetch_values_predicate: null -extra: null -normalize_columns: false -always_filter_main_dttm: false -uuid: f710a997-c65e-4aa6-aaed-b7d6998565ae -metrics: - - metric_name: count - verbose_name: COUNT(*) - metric_type: count - expression: COUNT(*) - description: null - d3format: null - currency: null - extra: - warning_markdown: "" - warning_text: null -columns: - - column_name: parent - verbose_name: null - is_dttm: false - is_active: true - type: INTEGER - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: {} - - column_name: count - verbose_name: null - is_dttm: false - is_active: true - type: INTEGER - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: {} - - column_name: id - verbose_name: null - is_dttm: false - is_active: true - type: INTEGER - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: {} - - column_name: name - verbose_name: null - is_dttm: false - is_active: true - type: STRING - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: {} -version: 1.0.0 -database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee diff --git a/superset/examples/configs/datasets/examples/project_management.yaml b/superset/examples/configs/datasets/examples/project_management.yaml deleted file mode 100644 index f5bb8f4a407..00000000000 --- a/superset/examples/configs/datasets/examples/project_management.yaml +++ /dev/null @@ -1,293 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -table_name: project_management -main_dttm_col: start_time -description: null -default_endpoint: null -offset: 0 -cache_timeout: null -catalog: examples -schema: public -sql: |- - SELECT - 1718870400000 AS start_time, - 1718874000000 AS end_time, - 'Project Alpha' AS project, - 'Design Phase' AS phase, - 'Initial design and architecture planning for Alpha.' AS description, - 'Completed' AS status, - 'High' AS priority - UNION ALL - SELECT - 1718872800000, - 1718877200000, - 'Project Alpha', - 'Development Phase', - 'Core feature development for Alpha project.', - 'In Progress', - 'High' - UNION ALL - SELECT - 1718876400000, - 1718880000000, - 'Project Alpha', - 'Testing Phase', - 'Internal testing and bug fixing for Alpha features.', - 'Planned', - 'Medium' - UNION ALL - SELECT - 1718878800000, - 1718882400000, - 'Project Alpha', - 'Deployment Phase', - 'Preparation and execution of Alpha deployment.', - 'On Hold', - 'High' - UNION ALL - SELECT - 1718880000000, - 1718883600000, - 'Project Beta', - 'Design Phase', - 'Gathering requirements and conceptual design for Beta.', - 'Completed', - 'Medium' - UNION ALL - SELECT - 1718882400000, - 1718886000000, - 'Project Beta', - 'Development Phase', - 'Module-wise development for Beta project.', - 'In Progress', - 'Medium' - UNION ALL - SELECT - 1718884800000, - 1718888400000, - 'Project Beta', - 'Testing Phase', - 'User acceptance testing for Beta release.', - 'Planned', - 'High' - UNION ALL - SELECT - 1718887200000, - 1718890800000, - 'Project Beta', - 'Deployment Phase', - 'Final checks and release of Beta version.', - 'Planned', - 'Medium' - UNION ALL - SELECT - 1718889600000, - 1718893200000, - 'Project Gamma', - 'Design Phase', - 'System design and database schema for Gamma.', - 'Completed', - 'Low' - UNION ALL - SELECT - 1718892000000, - 1718895600000, - 'Project Gamma', - 'Development Phase', - 'Backend API and frontend integration for Gamma.', - 'In Progress', - 'High' - UNION ALL - SELECT - 1718894400000, - 1718898000000, - 'Project Gamma', - 'Testing Phase', - 'Automated test suite execution for Gamma.', - 'Planned', - 'Medium' - UNION ALL - SELECT - 1718896800000, - 1718900400000, - 'Project Gamma', - 'Deployment Phase', - 'Handover and post-deployment support for Gamma.', - 'Planned', - 'Low' - UNION ALL - SELECT - 1718900000000, - 1718904000000, - 'Project Alpha', - 'Risk Assessment', - 'Analyzing potential risks and mitigation strategies.', - 'Completed', - 'High' - UNION ALL - SELECT - 1718902000000, - 1718906000000, - 'Project Beta', - 'Client Review', - 'Review meeting with key stakeholders for Beta.', - 'In Progress', - 'High' - UNION ALL - SELECT - 1718904000000, - 1718908000000, - 'Project Gamma', - 'Documentation', - 'Creating technical and user documentation.', - 'Planned', - 'Low' - UNION ALL - SELECT - 1718906000000, - 1718910000000, - 'Project Alpha', - 'Feature Implementation', - 'Implementing new requested features for Alpha.', - 'In Progress', - 'High' - UNION ALL - SELECT - 1718908000000, - 1718912000000, - 'Project Beta', - 'User Acceptance Testing', - 'Final UAT before production release.', - 'Planned', - 'High' - UNION ALL - SELECT - 1718910000000, - 1718914000000, - 'Project Gamma', - 'Bug Fixing', - 'Addressing critical bugs reported post-release.', - 'In Progress', - 'Medium'; -params: null -template_params: null -filter_select_enabled: true -fetch_values_predicate: null -extra: null -normalize_columns: false -always_filter_main_dttm: false -folders: null -uuid: d638a239-f255-44fc-b0c1-c3f3b7f00ee0 -metrics: -- metric_name: count - verbose_name: COUNT(*) - metric_type: count - expression: COUNT(*) - description: null - d3format: null - currency: null - extra: - warning_markdown: '' - warning_text: null -columns: -- column_name: start_time - verbose_name: null - is_dttm: true - is_active: true - type: LONGINTEGER - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: {} -- column_name: end_time - verbose_name: null - is_dttm: true - is_active: true - type: LONGINTEGER - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: {} -- column_name: phase - verbose_name: null - is_dttm: false - is_active: true - type: STRING - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: {} -- column_name: status - verbose_name: null - is_dttm: false - is_active: true - type: STRING - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: {} -- column_name: description - verbose_name: null - is_dttm: false - is_active: true - type: STRING - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: {} -- column_name: project - verbose_name: null - is_dttm: false - is_active: true - type: STRING - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: {} -- column_name: priority - verbose_name: null - is_dttm: false - is_active: true - type: STRING - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: {} -version: 1.0.0 -database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee diff --git a/superset/examples/configs/datasets/examples/users.yaml b/superset/examples/configs/datasets/examples/users.yaml deleted file mode 100644 index dd8b49fb40a..00000000000 --- a/superset/examples/configs/datasets/examples/users.yaml +++ /dev/null @@ -1,223 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -table_name: users -main_dttm_col: updated -description: null -default_endpoint: null -offset: 0 -cache_timeout: null -schema: null -sql: null -params: null -template_params: null -filter_select_enabled: true -fetch_values_predicate: null -extra: null -uuid: 7195db6b-2d17-7619-b7c7-26b15378df8c -metrics: - - metric_name: count - verbose_name: COUNT(*) - metric_type: count - expression: COUNT(*) - description: null - d3format: null - extra: null - warning_text: null -columns: - - column_name: updated - verbose_name: null - is_dttm: true - is_active: true - type: TIMESTAMP WITHOUT TIME ZONE - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: has_2fa - verbose_name: null - is_dttm: false - is_active: true - type: BOOLEAN - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: real_name - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: tz_label - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: team_id - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: name - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: color - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: id - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: tz - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: is_ultra_restricted - verbose_name: null - is_dttm: false - is_active: true - type: BOOLEAN - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: is_primary_owner - verbose_name: null - is_dttm: false - is_active: true - type: BOOLEAN - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: is_app_user - verbose_name: null - is_dttm: false - is_active: true - type: BOOLEAN - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: is_admin - verbose_name: null - is_dttm: false - is_active: true - type: BOOLEAN - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: is_bot - verbose_name: null - is_dttm: false - is_active: true - type: BOOLEAN - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: is_restricted - verbose_name: null - is_dttm: false - is_active: true - type: BOOLEAN - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: is_owner - verbose_name: null - is_dttm: false - is_active: true - type: BOOLEAN - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: deleted - verbose_name: null - is_dttm: false - is_active: true - type: BOOLEAN - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: tz_offset - verbose_name: null - is_dttm: false - is_active: true - type: BIGINT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -version: 1.0.0 -database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee -data: examples://datasets/examples/slack/users.csv diff --git a/superset/examples/configs/datasets/examples/users_channels-uzooNNtSRO.yaml b/superset/examples/configs/datasets/examples/users_channels-uzooNNtSRO.yaml deleted file mode 100644 index 5ba899be691..00000000000 --- a/superset/examples/configs/datasets/examples/users_channels-uzooNNtSRO.yaml +++ /dev/null @@ -1,77 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -table_name: users_channels-uzooNNtSRO -main_dttm_col: null -description: null -default_endpoint: null -offset: 0 -cache_timeout: null -schema: null -sql: > - SELECT uc1.name as channel_1, uc2.name as channel_2, count(*) AS cnt - FROM users_channels uc1 - JOIN users_channels uc2 ON uc1.user_id = uc2.user_id - GROUP BY uc1.name, uc2.name - HAVING uc1.name <> uc2.name -params: null -template_params: null -filter_select_enabled: true -fetch_values_predicate: null -extra: null -uuid: 473d6113-b44a-48d8-a6ae-e0ef7e2aebb0 -metrics: - - metric_name: count - verbose_name: null - metric_type: null - expression: count(*) - description: null - d3format: null - extra: null - warning_text: null -columns: - - column_name: channel_1 - verbose_name: null - is_dttm: false - is_active: true - type: STRING - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: channel_2 - verbose_name: null - is_dttm: false - is_active: true - type: STRING - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: cnt - verbose_name: null - is_dttm: false - is_active: true - type: INT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -version: 1.0.0 -database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee diff --git a/superset/examples/configs/datasets/examples/users_channels.yaml b/superset/examples/configs/datasets/examples/users_channels.yaml deleted file mode 100644 index 0b558094be9..00000000000 --- a/superset/examples/configs/datasets/examples/users_channels.yaml +++ /dev/null @@ -1,63 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -table_name: users_channels -main_dttm_col: null -description: null -default_endpoint: null -offset: 0 -cache_timeout: null -schema: null -sql: null -params: null -template_params: null -filter_select_enabled: true -fetch_values_predicate: null -extra: null -uuid: 29b18573-c9d6-40bc-b8cb-f70c9a1b6244 -metrics: - - metric_name: count - verbose_name: null - metric_type: null - expression: count(*) - description: null - d3format: null - extra: null - warning_text: null -columns: - - column_name: user_id - verbose_name: null - is_dttm: false - is_active: true - type: STRING - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: name - verbose_name: null - is_dttm: false - is_active: true - type: STRING - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -version: 1.0.0 -database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee -data: examples://datasets/examples/slack/users_channels.csv diff --git a/superset/examples/configs/datasets/examples/video_game_sales.yaml b/superset/examples/configs/datasets/examples/video_game_sales.yaml deleted file mode 100644 index ecf88108fe4..00000000000 --- a/superset/examples/configs/datasets/examples/video_game_sales.yaml +++ /dev/null @@ -1,156 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -table_name: video_game_sales -main_dttm_col: null -description: null -default_endpoint: null -offset: 0 -cache_timeout: null -schema: null -sql: "" -params: - remote_id: 64 - database_name: examples - import_time: 1606677834 -template_params: null -filter_select_enabled: true -fetch_values_predicate: null -extra: null -uuid: 53d47c0c-c03d-47f0-b9ac-81225f808283 -metrics: - - metric_name: count - verbose_name: COUNT(*) - metric_type: null - expression: COUNT(*) - description: null - d3format: null - extra: null - warning_text: null -columns: - - column_name: year - verbose_name: null - is_dttm: true - is_active: null - type: BIGINT - groupby: true - filterable: true - expression: null - description: null - python_date_format: "%Y" - - column_name: na_sales - verbose_name: null - is_dttm: false - is_active: null - type: FLOAT64 - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: eu_sales - verbose_name: null - is_dttm: false - is_active: null - type: FLOAT64 - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: global_sales - verbose_name: null - is_dttm: false - is_active: null - type: FLOAT64 - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: jp_sales - verbose_name: null - is_dttm: false - is_active: null - type: FLOAT64 - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: other_sales - verbose_name: null - is_dttm: false - is_active: null - type: FLOAT64 - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: rank - verbose_name: null - is_dttm: false - is_active: null - type: BIGINT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: genre - verbose_name: null - is_dttm: false - is_active: null - type: STRING - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: name - verbose_name: null - is_dttm: false - is_active: null - type: STRING - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: platform - verbose_name: null - is_dttm: false - is_active: null - type: STRING - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - - column_name: publisher - verbose_name: null - is_dttm: false - is_active: null - type: STRING - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -version: 1.0.0 -database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee -data: examples://datasets/examples/video_game_sales.csv diff --git a/superset/examples/country_map.py b/superset/examples/country_map.py deleted file mode 100644 index 06eec473cbb..00000000000 --- a/superset/examples/country_map.py +++ /dev/null @@ -1,123 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -import datetime -import logging - -from sqlalchemy import BigInteger, Date, inspect, String -from sqlalchemy.sql import column - -import superset.utils.database as database_utils -from superset import db -from superset.connectors.sqla.models import SqlMetric -from superset.models.slice import Slice -from superset.sql.parse import Table -from superset.utils.core import DatasourceType - -from .helpers import ( - get_slice_json, - get_table_connector_registry, - merge_slice, - misc_dash_slices, - read_example_data, -) - -logger = logging.getLogger(__name__) - - -def load_country_map_data(only_metadata: bool = False, force: bool = False) -> None: - """Loading data for map with country map""" - tbl_name = "birth_france_by_region" - database = database_utils.get_example_database() - - with database.get_sqla_engine() as engine: - schema = inspect(engine).default_schema_name - table_exists = database.has_table(Table(tbl_name, schema)) - - if not only_metadata and (not table_exists or force): - data = read_example_data( - "examples://birth_france_data_for_country_map.csv", encoding="utf-8" - ) - data["dttm"] = datetime.datetime.now().date() - data.to_sql( - tbl_name, - engine, - schema=schema, - if_exists="replace", - chunksize=500, - dtype={ - "DEPT_ID": String(10), - "2003": BigInteger, - "2004": BigInteger, - "2005": BigInteger, - "2006": BigInteger, - "2007": BigInteger, - "2008": BigInteger, - "2009": BigInteger, - "2010": BigInteger, - "2011": BigInteger, - "2012": BigInteger, - "2013": BigInteger, - "2014": BigInteger, - "dttm": Date(), - }, - index=False, - ) - logger.debug("Done loading table!") - logger.debug("-" * 80) - - logger.debug("Creating table reference") - table = get_table_connector_registry() - obj = db.session.query(table).filter_by(table_name=tbl_name).first() - if not obj: - obj = table(table_name=tbl_name, schema=schema) - db.session.add(obj) - obj.main_dttm_col = "dttm" - obj.database = database - obj.filter_select_enabled = True - if not any(col.metric_name == "avg__2004" for col in obj.metrics): - col = str(column("2004").compile(db.engine)) - obj.metrics.append(SqlMetric(metric_name="avg__2004", expression=f"AVG({col})")) - obj.fetch_metadata() - tbl = obj - - slice_data = { - "granularity_sqla": "", - "since": "", - "until": "", - "viz_type": "country_map", - "entity": "DEPT_ID", - "metric": { - "expressionType": "SIMPLE", - "column": {"type": "INT", "column_name": "2004"}, - "aggregate": "AVG", - "label": "Boys", - "optionName": "metric_112342", - }, - "row_limit": 500000, - "select_country": "france", - } - - logger.debug("Creating a slice") - slc = Slice( - slice_name="Birth in France by department in 2016", - viz_type="country_map", - datasource_type=DatasourceType.TABLE, - datasource_id=tbl.id, - params=get_slice_json(slice_data), - ) - misc_dash_slices.add(slc.slice_name) - merge_slice(slc) diff --git a/superset/examples/data_loading.py b/superset/examples/data_loading.py index b7d9c663f68..c32f0fb0ab1 100644 --- a/superset/examples/data_loading.py +++ b/superset/examples/data_loading.py @@ -14,44 +14,173 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -from .bart_lines import load_bart_lines -from .big_data import load_big_data -from .birth_names import load_birth_names -from .country_map import load_country_map_data -from .css_templates import load_css_templates -from .deck import load_deck_dash -from .energy import load_energy -from .flights import load_flights -from .international_sales import load_international_sales -from .long_lat import load_long_lat_data -from .misc_dashboard import load_misc_dashboard -from .multiformat_time_series import load_multiformat_time_series -from .paris import load_paris_iris_geojson -from .random_time_series import load_random_time_series_data -from .sf_population_polygons import load_sf_population_polygons -from .supported_charts_dashboard import load_supported_charts_dashboard -from .tabbed_dashboard import load_tabbed_dashboard -from .utils import load_examples_from_configs -from .world_bank import load_world_bank_health_n_pop +"""Auto-discover and load example datasets from Parquet files.""" +import logging +from pathlib import Path +from typing import Any, Callable, Dict, Optional + +import yaml + +# Import loaders that have custom logic (dashboards, CSS, etc.) +from superset.cli.test_loaders import load_big_data + +from .css_templates import load_css_templates + +# Import generic loader for Parquet datasets +from .generic_loader import create_generic_loader +from .utils import load_examples_from_configs + +logger = logging.getLogger(__name__) + + +def get_dataset_config_from_yaml(example_dir: Path) -> Dict[str, Optional[str]]: + """Read table_name, schema, and data_file from dataset.yaml if it exists.""" + result: Dict[str, Optional[str]] = { + "table_name": None, + "schema": None, + "data_file": None, + } + dataset_yaml = example_dir / "dataset.yaml" + if dataset_yaml.exists(): + try: + with open(dataset_yaml) as f: + config = yaml.safe_load(f) + result["table_name"] = config.get("table_name") + result["data_file"] = config.get("data_file") + schema = config.get("schema") + # Treat SQLite's 'main' schema as null (use target database default) + result["schema"] = None if schema == "main" else schema + except Exception: + logger.debug("Could not read dataset.yaml from %s", example_dir) + return result + + +def get_examples_directory() -> Path: + """Get the path to the examples directory.""" + from .helpers import get_examples_folder + + return Path(get_examples_folder()) + + +def _get_multi_dataset_config( + example_dir: Path, dataset_name: str, data_file: Path +) -> Dict[str, Any]: + """Read config for a multi-dataset example from datasets/{name}.yaml.""" + datasets_yaml = example_dir / "datasets" / f"{dataset_name}.yaml" + result: Dict[str, Any] = { + "table_name": dataset_name, + "schema": None, + "data_file": data_file, + } + + if not datasets_yaml.exists(): + return result + + try: + with open(datasets_yaml) as f: + yaml_config = yaml.safe_load(f) + result["table_name"] = yaml_config.get("table_name") or dataset_name + raw_schema = yaml_config.get("schema") + result["schema"] = None if raw_schema == "main" else raw_schema + + # Use explicit data_file from YAML if specified + explicit_data_file = yaml_config.get("data_file") + if explicit_data_file: + candidate = example_dir / "data" / explicit_data_file + if candidate.exists(): + result["data_file"] = candidate + else: + logger.warning( + "data_file '%s' specified in YAML does not exist", + explicit_data_file, + ) + except Exception: + logger.debug("Could not read datasets yaml from %s", datasets_yaml) + + return result + + +def discover_datasets() -> Dict[str, Callable[..., None]]: + """Auto-discover all example datasets and create loaders for them. + + Examples are organized as: + superset/examples/{example_name}/data.parquet # Single dataset + superset/examples/{example_name}/data/{name}.parquet # Multiple datasets + + Table names and data file references are read from dataset.yaml/datasets/*.yaml + if present, otherwise derived from the folder/file name. + """ + loaders: Dict[str, Callable[..., None]] = {} + examples_dir = get_examples_directory() + + if not examples_dir.exists(): + return loaders + + # Discover single data.parquet files (simple examples) + for data_file in sorted(examples_dir.glob("*/data.parquet")): + example_dir = data_file.parent + dataset_name = example_dir.name + + if dataset_name.startswith("_"): + continue + + config = get_dataset_config_from_yaml(example_dir) + table_name = config["table_name"] or dataset_name + explicit_data_file = config.get("data_file") + if explicit_data_file: + resolved_file = example_dir / explicit_data_file + else: + resolved_file = data_file + if explicit_data_file and not resolved_file.exists(): + logger.warning("data_file '%s' does not exist", explicit_data_file) + resolved_file = data_file + + loader_name = f"load_{dataset_name}" + loaders[loader_name] = create_generic_loader( + dataset_name, + table_name=table_name, + schema=config["schema"], + data_file=resolved_file, + ) + + # Discover multiple parquet files in data/ folders (complex examples) + for data_file in sorted(examples_dir.glob("*/data/*.parquet")): + dataset_name = data_file.stem + example_dir = data_file.parent.parent + + if example_dir.name.startswith("_"): + continue + + config = _get_multi_dataset_config(example_dir, dataset_name, data_file) + loader_name = f"load_{dataset_name}" + if loader_name not in loaders: + loaders[loader_name] = create_generic_loader( + dataset_name, + table_name=config["table_name"], + schema=config["schema"], + data_file=config["data_file"], + ) + + return loaders + + +# Auto-discover and create all dataset loaders +try: + _auto_loaders = discover_datasets() +except RuntimeError: + # Outside Flask app context (e.g., tests, tooling) + _auto_loaders = {} + +# Add auto-discovered loaders to module namespace +globals().update(_auto_loaders) + +# Build __all__ list dynamically __all__ = [ - "load_bart_lines", + # Custom loaders (always included) "load_big_data", - "load_birth_names", - "load_country_map_data", "load_css_templates", - "load_international_sales", - "load_deck_dash", - "load_energy", - "load_flights", - "load_long_lat_data", - "load_misc_dashboard", - "load_multiformat_time_series", - "load_paris_iris_geojson", - "load_random_time_series_data", - "load_sf_population_polygons", - "load_supported_charts_dashboard", - "load_tabbed_dashboard", "load_examples_from_configs", - "load_world_bank_health_n_pop", + # Auto-discovered loaders + *sorted(_auto_loaders.keys()), ] diff --git a/superset/examples/deck.py b/superset/examples/deck.py deleted file mode 100644 index 988e7dc6939..00000000000 --- a/superset/examples/deck.py +++ /dev/null @@ -1,547 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. - -import logging - -from superset import db -from superset.models.dashboard import Dashboard -from superset.models.slice import Slice -from superset.utils import json -from superset.utils.core import DatasourceType - -from .helpers import ( - get_slice_json, - get_table_connector_registry, - merge_slice, - update_slice_ids, -) - -logger = logging.getLogger(__name__) - -COLOR_RED = {"r": 205, "g": 0, "b": 3, "a": 0.82} -POSITION_JSON = """\ -{ - "CHART-3afd9d70": { - "meta": { - "chartId": 66, - "sliceName": "Deck.gl Scatterplot", - "width": 6, - "height": 50 - }, - "type": "CHART", - "id": "CHART-3afd9d70", - "children": [] - }, - "CHART-2ee7fa5e": { - "meta": { - "chartId": 67, - "sliceName": "Deck.gl Screen grid", - "width": 6, - "height": 50 - }, - "type": "CHART", - "id": "CHART-2ee7fa5e", - "children": [] - }, - "CHART-201f7715": { - "meta": { - "chartId": 68, - "sliceName": "Deck.gl Hexagons", - "width": 6, - "height": 50 - }, - "type": "CHART", - "id": "CHART-201f7715", - "children": [] - }, - "CHART-d02f6c40": { - "meta": { - "chartId": 69, - "sliceName": "Deck.gl Grid", - "width": 6, - "height": 50 - }, - "type": "CHART", - "id": "CHART-d02f6c40", - "children": [] - }, - "CHART-2673431d": { - "meta": { - "chartId": 70, - "sliceName": "Deck.gl Polygons", - "width": 6, - "height": 50 - }, - "type": "CHART", - "id": "CHART-2673431d", - "children": [] - }, - "CHART-85265a60": { - "meta": { - "chartId": 71, - "sliceName": "Deck.gl Arcs", - "width": 6, - "height": 50 - }, - "type": "CHART", - "id": "CHART-85265a60", - "children": [] - }, - "CHART-2b87513c": { - "meta": { - "chartId": 72, - "sliceName": "Deck.gl Path", - "width": 6, - "height": 50 - }, - "type": "CHART", - "id": "CHART-2b87513c", - "children": [] - }, - "GRID_ID": { - "type": "GRID", - "id": "GRID_ID", - "children": [ - "ROW-a7b16cb5", - "ROW-72c218a5", - "ROW-957ba55b", - "ROW-af041bdd" - ] - }, - "HEADER_ID": { - "meta": { - "text": "deck.gl Demo" - }, - "type": "HEADER", - "id": "HEADER_ID" - }, - "ROOT_ID": { - "type": "ROOT", - "id": "ROOT_ID", - "children": [ - "GRID_ID" - ] - }, - "ROW-72c218a5": { - "meta": { - "background": "BACKGROUND_TRANSPARENT" - }, - "type": "ROW", - "id": "ROW-72c218a5", - "children": [ - "CHART-d02f6c40", - "CHART-201f7715" - ] - }, - "ROW-957ba55b": { - "meta": { - "background": "BACKGROUND_TRANSPARENT" - }, - "type": "ROW", - "id": "ROW-957ba55b", - "children": [ - "CHART-2673431d", - "CHART-85265a60" - ] - }, - "ROW-a7b16cb5": { - "meta": { - "background": "BACKGROUND_TRANSPARENT" - }, - "type": "ROW", - "id": "ROW-a7b16cb5", - "children": [ - "CHART-3afd9d70", - "CHART-2ee7fa5e" - ] - }, - "ROW-af041bdd": { - "meta": { - "background": "BACKGROUND_TRANSPARENT" - }, - "type": "ROW", - "id": "ROW-af041bdd", - "children": [ - "CHART-2b87513c" - ] - }, - "DASHBOARD_VERSION_KEY": "v2" -}""" - - -def load_deck_dash() -> None: # pylint: disable=too-many-statements - logger.debug("Loading deck.gl dashboard") - slices = [] - table = get_table_connector_registry() - tbl = db.session.query(table).filter_by(table_name="long_lat").first() - slice_data = { - "spatial": {"type": "latlong", "lonCol": "LON", "latCol": "LAT"}, - "color_picker": COLOR_RED, - "datasource": "5__table", - "granularity_sqla": None, - "groupby": [], - "mapbox_style": "https://tile.openstreetmap.org/{z}/{x}/{y}.png", - "multiplier": 10, - "point_radius_fixed": {"type": "metric", "value": "count"}, - "point_unit": "square_m", - "min_radius": 1, - "max_radius": 250, - "row_limit": 5000, - "time_range": " : ", - "size": "count", - "time_grain_sqla": None, - "viewport": { - "bearing": -4.952916738791771, - "latitude": 37.78926922909199, - "longitude": -122.42613341901688, - "pitch": 4.750411100577438, - "zoom": 12.729132798697304, - }, - "viz_type": "deck_scatter", - } - - logger.debug("Creating Scatterplot slice") - slc = Slice( - slice_name="Deck.gl Scatterplot", - viz_type="deck_scatter", - datasource_type=DatasourceType.TABLE, - datasource_id=tbl.id, - params=get_slice_json(slice_data), - ) - merge_slice(slc) - slices.append(slc) - - slice_data = { - "point_unit": "square_m", - "row_limit": 5000, - "spatial": {"type": "latlong", "lonCol": "LON", "latCol": "LAT"}, - "mapbox_style": "https://tile.openstreetmap.org/{z}/{x}/{y}.png", - "granularity_sqla": None, - "size": "count", - "viz_type": "deck_screengrid", - "time_range": "No filter", - "point_radius": "Auto", - "color_picker": {"a": 1, "r": 14, "b": 0, "g": 255}, - "grid_size": 20, - "viewport": { - "zoom": 14.161641703941438, - "longitude": -122.41827069521386, - "bearing": -4.952916738791771, - "latitude": 37.76024135844065, - "pitch": 4.750411100577438, - }, - "point_radius_fixed": {"type": "fix", "value": 2000}, - "datasource": "5__table", - "time_grain_sqla": None, - "groupby": [], - } - logger.debug("Creating Screen Grid slice") - slc = Slice( - slice_name="Deck.gl Screen grid", - viz_type="deck_screengrid", - datasource_type=DatasourceType.TABLE, - datasource_id=tbl.id, - params=get_slice_json(slice_data), - ) - merge_slice(slc) - slices.append(slc) - - slice_data = { - "spatial": {"type": "latlong", "lonCol": "LON", "latCol": "LAT"}, - "row_limit": 5000, - "mapbox_style": "https://tile.openstreetmap.org/{z}/{x}/{y}.png", - "granularity_sqla": None, - "size": "count", - "viz_type": "deck_hex", - "time_range": "No filter", - "point_radius_unit": "Pixels", - "point_radius": "Auto", - "color_picker": {"a": 1, "r": 14, "b": 0, "g": 255}, - "grid_size": 40, - "extruded": True, - "viewport": { - "latitude": 37.789795085160335, - "pitch": 54.08961642447763, - "zoom": 13.835465702403654, - "longitude": -122.40632230075536, - "bearing": -2.3984797349335167, - }, - "point_radius_fixed": {"type": "fix", "value": 2000}, - "datasource": "5__table", - "time_grain_sqla": None, - "groupby": [], - } - logger.debug("Creating Hex slice") - slc = Slice( - slice_name="Deck.gl Hexagons", - viz_type="deck_hex", - datasource_type=DatasourceType.TABLE, - datasource_id=tbl.id, - params=get_slice_json(slice_data), - ) - merge_slice(slc) - slices.append(slc) - - slice_data = { - "autozoom": False, - "spatial": {"type": "latlong", "lonCol": "LON", "latCol": "LAT"}, - "row_limit": 5000, - "mapbox_style": "https://tile.openstreetmap.org/{z}/{x}/{y}.png", - "granularity_sqla": None, - "size": "count", - "viz_type": "deck_grid", - "point_radius_unit": "Pixels", - "point_radius": "Auto", - "time_range": "No filter", - "color_picker": {"a": 1, "r": 14, "b": 0, "g": 255}, - "grid_size": 120, - "extruded": True, - "viewport": { - "longitude": -122.42066918995666, - "bearing": 155.80099696026355, - "zoom": 12.699690845482069, - "latitude": 37.7942314882596, - "pitch": 53.470800300695146, - }, - "point_radius_fixed": {"type": "fix", "value": 2000}, - "datasource": "5__table", - "time_grain_sqla": None, - "groupby": [], - } - logger.debug("Creating Grid slice") - slc = Slice( - slice_name="Deck.gl Grid", - viz_type="deck_grid", - datasource_type=DatasourceType.TABLE, - datasource_id=tbl.id, - params=get_slice_json(slice_data), - ) - merge_slice(slc) - slices.append(slc) - - polygon_tbl = ( - db.session.query(table).filter_by(table_name="sf_population_polygons").first() - ) - slice_data = { - "datasource": "11__table", - "viz_type": "deck_polygon", - "slice_id": 41, - "granularity_sqla": None, - "time_grain_sqla": None, - "time_range": " : ", - "line_column": "contour", - "metric": { - "aggregate": "SUM", - "column": { - "column_name": "population", - "description": None, - "expression": None, - "filterable": True, - "groupby": True, - "id": 1332, - "is_dttm": False, - "optionName": "_col_population", - "python_date_format": None, - "type": "BIGINT", - "verbose_name": None, - }, - "expressionType": "SIMPLE", - "hasCustomLabel": True, - "label": "Population", - "optionName": "metric_t2v4qbfiz1_w6qgpx4h2p", - "sqlExpression": None, - }, - "line_type": "json", - "linear_color_scheme": "oranges", - "mapbox_style": "https://tile.openstreetmap.org/{z}/{x}/{y}.png", - "viewport": { - "longitude": -122.43388541747726, - "latitude": 37.752020331384834, - "zoom": 11.133995608594631, - "bearing": 37.89506450385642, - "pitch": 60, - "width": 667, - "height": 906, - "altitude": 1.5, - "maxZoom": 20, - "minZoom": 0, - "maxPitch": 60, - "minPitch": 0, - "maxLatitude": 85.05113, - "minLatitude": -85.05113, - }, - "reverse_long_lat": False, - "fill_color_picker": {"r": 3, "g": 65, "b": 73, "a": 1}, - "stroke_color_picker": {"r": 0, "g": 122, "b": 135, "a": 1}, - "filled": True, - "stroked": False, - "extruded": True, - "multiplier": 0.1, - "line_width": 10, - "line_width_unit": "meters", - "point_radius_fixed": { - "type": "metric", - "value": { - "aggregate": None, - "column": None, - "expressionType": "SQL", - "hasCustomLabel": None, - "label": "Density", - "optionName": "metric_c5rvwrzoo86_293h6yrv2ic", - "sqlExpression": "SUM(population)/SUM(area)", - }, - }, - "js_columns": [], - "js_data_mutator": "", - "js_tooltip": "", - "js_onclick_href": "", - "legend_format": ".1s", - "legend_position": "tr", - } - - logger.debug("Creating Polygon slice") - slc = Slice( - slice_name="Deck.gl Polygons", - viz_type="deck_polygon", - datasource_type=DatasourceType.TABLE, - datasource_id=polygon_tbl.id, - params=get_slice_json(slice_data), - ) - merge_slice(slc) - slices.append(slc) - - slice_data = { - "datasource": "10__table", - "viz_type": "deck_arc", - "slice_id": 42, - "granularity_sqla": None, - "time_grain_sqla": None, - "time_range": " : ", - "start_spatial": { - "type": "latlong", - "latCol": "LATITUDE", - "lonCol": "LONGITUDE", - }, - "end_spatial": { - "type": "latlong", - "latCol": "LATITUDE_DEST", - "lonCol": "LONGITUDE_DEST", - }, - "row_limit": 5000, - "mapbox_style": "https://tile.openstreetmap.org/{z}/{x}/{y}.png", - "viewport": { - "altitude": 1.5, - "bearing": 8.546256357301871, - "height": 642, - "latitude": 44.596651438714254, - "longitude": -91.84340711201104, - "maxLatitude": 85.05113, - "maxPitch": 60, - "maxZoom": 20, - "minLatitude": -85.05113, - "minPitch": 0, - "minZoom": 0, - "pitch": 60, - "width": 997, - "zoom": 2.929837070560775, - }, - "color_picker": {"r": 0, "g": 122, "b": 135, "a": 1}, - "stroke_width": 1, - } - - logger.debug("Creating Arc slice") - slc = Slice( - slice_name="Deck.gl Arcs", - viz_type="deck_arc", - datasource_type=DatasourceType.TABLE, - datasource_id=db.session.query(table) - .filter_by(table_name="flights") - .first() - .id, - params=get_slice_json(slice_data), - ) - merge_slice(slc) - slices.append(slc) - - slice_data = { - "datasource": "12__table", - "slice_id": 43, - "viz_type": "deck_path", - "time_grain_sqla": None, - "time_range": " : ", - "line_column": "path_json", - "line_type": "json", - "row_limit": 5000, - "mapbox_style": "https://tile.openstreetmap.org/{z}/{x}/{y}.png", - "viewport": { - "longitude": -122.18885402582598, - "latitude": 37.73671752604488, - "zoom": 9.51847667620428, - "bearing": 0, - "pitch": 0, - "width": 669, - "height": 1094, - "altitude": 1.5, - "maxZoom": 20, - "minZoom": 0, - "maxPitch": 60, - "minPitch": 0, - "maxLatitude": 85.05113, - "minLatitude": -85.05113, - }, - "color_picker": {"r": 0, "g": 122, "b": 135, "a": 1}, - "line_width": 150, - "reverse_long_lat": False, - "js_columns": ["color"], - "js_data_mutator": "data => data.map(d => ({\n" - " ...d,\n" - " color: colors.hexToRGB(d.extraProps.color)\n" - "}));", - "js_tooltip": "", - "js_onclick_href": "", - } - - logger.debug("Creating Path slice") - slc = Slice( - slice_name="Deck.gl Path", - viz_type="deck_path", - datasource_type=DatasourceType.TABLE, - datasource_id=db.session.query(table) - .filter_by(table_name="bart_lines") - .first() - .id, - params=get_slice_json(slice_data), - ) - merge_slice(slc) - slices.append(slc) - slug = "deck" - - logger.debug("Creating a dashboard") - title = "deck.gl Demo" - dash = db.session.query(Dashboard).filter_by(slug=slug).first() - - if not dash: - dash = Dashboard() - db.session.add(dash) - dash.published = True - js = POSITION_JSON - pos = json.loads(js) - slices = update_slice_ids(pos) - dash.position_json = json.dumps(pos, indent=4) - dash.dashboard_title = title - dash.slug = slug - dash.slices = slices diff --git a/superset/examples/deckgl_demo/charts/Deck.gl_Arcs.yaml b/superset/examples/deckgl_demo/charts/Deck.gl_Arcs.yaml new file mode 100644 index 00000000000..a27b1a05a41 --- /dev/null +++ b/superset/examples/deckgl_demo/charts/Deck.gl_Arcs.yaml @@ -0,0 +1,64 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: b474edce-88e2-4ac4-be63-272a9f1dabe7 +description: null +params: + color_picker: + a: 1 + b: 135 + g: 122 + r: 0 + datasource: 10__table + end_spatial: + latCol: LATITUDE_DEST + lonCol: LONGITUDE_DEST + type: latlong + granularity_sqla: null + mapbox_style: https://tile.openstreetmap.org/{z}/{x}/{y}.png + row_limit: 5000 + slice_id: 42 + start_spatial: + latCol: LATITUDE + lonCol: LONGITUDE + type: latlong + stroke_width: 1 + time_grain_sqla: null + time_range: ' : ' + viewport: + altitude: 1.5 + bearing: 8.546256357301871 + height: 642 + latitude: 44.596651438714254 + longitude: -91.84340711201104 + maxLatitude: 85.05113 + maxPitch: 60 + maxZoom: 20 + minLatitude: -85.05113 + minPitch: 0 + minZoom: 0 + pitch: 60 + width: 997 + zoom: 2.929837070560775 + viz_type: deck_arc +query_context: null +slice_name: Deck.gl Arcs +uuid: 8663e6d2-5589-49f6-889a-335e8dc15119 +version: 1.0.0 +viz_type: deck_arc diff --git a/superset/examples/deckgl_demo/charts/Deck.gl_Grid.yaml b/superset/examples/deckgl_demo/charts/Deck.gl_Grid.yaml new file mode 100644 index 00000000000..e446e327712 --- /dev/null +++ b/superset/examples/deckgl_demo/charts/Deck.gl_Grid.yaml @@ -0,0 +1,59 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: a46c986d-8780-4745-91ff-7fefeef69f3c +description: null +params: + autozoom: false + color_picker: + a: 1 + b: 0 + g: 255 + r: 14 + datasource: 5__table + extruded: true + granularity_sqla: null + grid_size: 120 + groupby: [] + mapbox_style: https://tile.openstreetmap.org/{z}/{x}/{y}.png + point_radius: Auto + point_radius_fixed: + type: fix + value: 2000 + point_radius_unit: Pixels + row_limit: 5000 + size: count + spatial: + latCol: LAT + lonCol: LON + type: latlong + time_grain_sqla: null + time_range: No filter + viewport: + bearing: 155.80099696026355 + latitude: 37.7942314882596 + longitude: -122.42066918995666 + pitch: 53.470800300695146 + zoom: 12.699690845482069 + viz_type: deck_grid +query_context: null +slice_name: Deck.gl Grid +uuid: 5a42df97-80a7-49ee-8985-fcb7fc0bf281 +version: 1.0.0 +viz_type: deck_grid diff --git a/superset/examples/configs/charts/COVID Vaccines/Vaccine_Candidates_per_Approach__Stage.yaml b/superset/examples/deckgl_demo/charts/Deck.gl_Hexagons.yaml similarity index 50% rename from superset/examples/configs/charts/COVID Vaccines/Vaccine_Candidates_per_Approach__Stage.yaml rename to superset/examples/deckgl_demo/charts/Deck.gl_Hexagons.yaml index 388a8504b9d..86df71c5ba3 100644 --- a/superset/examples/configs/charts/COVID Vaccines/Vaccine_Candidates_per_Approach__Stage.yaml +++ b/superset/examples/deckgl_demo/charts/Deck.gl_Hexagons.yaml @@ -14,37 +14,45 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Vaccine Candidates per Approach & Stage -viz_type: heatmap_v2 -params: - adhoc_filters: [] - x_axis: clinical_stage - groupby: product_category - bottom_margin: auto - datasource: 69__table - left_margin: auto - linear_color_scheme: schemeYlOrBr - metric: count - normalize_across: heatmap_v2 - queryFields: - metric: metrics - row_limit: 10000 - show_legend: false - show_percentage: true - show_values: true - slice_id: 3962 - sort_x_axis: alpha_asc - sort_y_axis: alpha_asc - time_range: No filter - url_params: {} - viz_type: heatmap_v2 - xscale_interval: null - value_bounds: - - null - - null - y_axis_format: SMART_NUMBER - yscale_interval: null cache_timeout: null -uuid: 0c953c84-0c9a-418d-be9f-2894d2a2cee0 +certification_details: null +certified_by: null +dataset_uuid: a46c986d-8780-4745-91ff-7fefeef69f3c +description: null +params: + color_picker: + a: 1 + b: 0 + g: 255 + r: 14 + datasource: 5__table + extruded: true + granularity_sqla: null + grid_size: 40 + groupby: [] + mapbox_style: https://tile.openstreetmap.org/{z}/{x}/{y}.png + point_radius: Auto + point_radius_fixed: + type: fix + value: 2000 + point_radius_unit: Pixels + row_limit: 5000 + size: count + spatial: + latCol: LAT + lonCol: LON + type: latlong + time_grain_sqla: null + time_range: No filter + viewport: + bearing: -2.3984797349335167 + latitude: 37.789795085160335 + longitude: -122.40632230075536 + pitch: 54.08961642447763 + zoom: 13.835465702403654 + viz_type: deck_hex +query_context: null +slice_name: Deck.gl Hexagons +uuid: 7487e265-39d8-4ccd-b8f4-51f8b32ce073 version: 1.0.0 -dataset_uuid: 974b7a1c-22ea-49cb-9214-97b7dbd511e0 +viz_type: deck_hex diff --git a/superset/examples/deckgl_demo/charts/Deck.gl_Path.yaml b/superset/examples/deckgl_demo/charts/Deck.gl_Path.yaml new file mode 100644 index 00000000000..993eb802ef5 --- /dev/null +++ b/superset/examples/deckgl_demo/charts/Deck.gl_Path.yaml @@ -0,0 +1,64 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 56a8f963-1298-42a5-99d8-24fd90ab012d +description: null +params: + color_picker: + a: 1 + b: 135 + g: 122 + r: 0 + datasource: 12__table + js_columns: + - color + js_data_mutator: "data => data.map(d => ({\n ...d,\n color: colors.hexToRGB(d.extraProps.color)\n\ + }));" + js_onclick_href: '' + js_tooltip: '' + line_column: path_json + line_type: json + line_width: 150 + mapbox_style: https://tile.openstreetmap.org/{z}/{x}/{y}.png + reverse_long_lat: false + row_limit: 5000 + slice_id: 43 + time_grain_sqla: null + time_range: ' : ' + viewport: + altitude: 1.5 + bearing: 0 + height: 1094 + latitude: 37.73671752604488 + longitude: -122.18885402582598 + maxLatitude: 85.05113 + maxPitch: 60 + maxZoom: 20 + minLatitude: -85.05113 + minPitch: 0 + minZoom: 0 + pitch: 0 + width: 669 + zoom: 9.51847667620428 + viz_type: deck_path +query_context: null +slice_name: Deck.gl Path +uuid: e871563b-6b80-4629-b606-ab9054da1fbf +version: 1.0.0 +viz_type: deck_path diff --git a/superset/examples/deckgl_demo/charts/Deck.gl_Polygons.yaml b/superset/examples/deckgl_demo/charts/Deck.gl_Polygons.yaml new file mode 100644 index 00000000000..172b6536e1f --- /dev/null +++ b/superset/examples/deckgl_demo/charts/Deck.gl_Polygons.yaml @@ -0,0 +1,104 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: c8f4035a-0771-4f93-b204-9b9581c555ec +description: null +params: + datasource: 11__table + extruded: true + fill_color_picker: + a: 1 + b: 73 + g: 65 + r: 3 + filled: true + granularity_sqla: null + js_columns: [] + js_data_mutator: '' + js_onclick_href: '' + js_tooltip: '' + legend_format: .1s + legend_position: tr + line_column: contour + line_type: json + line_width: 10 + line_width_unit: meters + linear_color_scheme: oranges + mapbox_style: https://tile.openstreetmap.org/{z}/{x}/{y}.png + metric: + aggregate: SUM + column: + column_name: population + description: null + expression: null + filterable: true + groupby: true + id: 1332 + is_dttm: false + optionName: _col_population + python_date_format: null + type: BIGINT + verbose_name: null + expressionType: SIMPLE + hasCustomLabel: true + label: Population + optionName: metric_t2v4qbfiz1_w6qgpx4h2p + sqlExpression: null + multiplier: 0.1 + point_radius_fixed: + type: metric + value: + aggregate: null + column: null + expressionType: SQL + hasCustomLabel: null + label: Density + optionName: metric_c5rvwrzoo86_293h6yrv2ic + sqlExpression: SUM(population)/SUM(area) + reverse_long_lat: false + slice_id: 41 + stroke_color_picker: + a: 1 + b: 135 + g: 122 + r: 0 + stroked: false + time_grain_sqla: null + time_range: ' : ' + viewport: + altitude: 1.5 + bearing: 37.89506450385642 + height: 906 + latitude: 37.752020331384834 + longitude: -122.43388541747726 + maxLatitude: 85.05113 + maxPitch: 60 + maxZoom: 20 + minLatitude: -85.05113 + minPitch: 0 + minZoom: 0 + pitch: 60 + width: 667 + zoom: 11.133995608594631 + viz_type: deck_polygon +query_context: null +slice_name: Deck.gl Polygons +uuid: 1964e7e3-6836-42f5-9218-026fd194d6c2 +version: 1.0.0 +viz_type: deck_polygon diff --git a/superset/examples/deckgl_demo/charts/Deck.gl_Scatterplot.yaml b/superset/examples/deckgl_demo/charts/Deck.gl_Scatterplot.yaml new file mode 100644 index 00000000000..d055082a09e --- /dev/null +++ b/superset/examples/deckgl_demo/charts/Deck.gl_Scatterplot.yaml @@ -0,0 +1,58 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: a46c986d-8780-4745-91ff-7fefeef69f3c +description: null +params: + color_picker: + a: 0.82 + b: 3 + g: 0 + r: 205 + datasource: 5__table + granularity_sqla: null + groupby: [] + mapbox_style: https://tile.openstreetmap.org/{z}/{x}/{y}.png + max_radius: 250 + min_radius: 1 + multiplier: 10 + point_radius_fixed: + type: metric + value: count + point_unit: square_m + row_limit: 5000 + size: count + spatial: + latCol: LAT + lonCol: LON + type: latlong + time_grain_sqla: null + time_range: ' : ' + viewport: + bearing: -4.952916738791771 + latitude: 37.78926922909199 + longitude: -122.42613341901688 + pitch: 4.750411100577438 + zoom: 12.729132798697304 + viz_type: deck_scatter +query_context: null +slice_name: Deck.gl Scatterplot +uuid: 36706f55-dec0-46d8-9dab-50842690d8d8 +version: 1.0.0 +viz_type: deck_scatter diff --git a/superset/examples/configs/charts/COVID Vaccines/Vaccine_Candidates_per_Country__Stage_749.yaml b/superset/examples/deckgl_demo/charts/Deck.gl_Screen_grid.yaml similarity index 50% rename from superset/examples/configs/charts/COVID Vaccines/Vaccine_Candidates_per_Country__Stage_749.yaml rename to superset/examples/deckgl_demo/charts/Deck.gl_Screen_grid.yaml index 13a761d9f6b..4e5a50a9a4f 100644 --- a/superset/examples/configs/charts/COVID Vaccines/Vaccine_Candidates_per_Country__Stage_749.yaml +++ b/superset/examples/deckgl_demo/charts/Deck.gl_Screen_grid.yaml @@ -14,33 +14,44 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Vaccine Candidates per Country & Stage -viz_type: heatmap_v2 -params: - adhoc_filters: [] - x_axis: clinical_stage - groupby: country_name - bottom_margin: auto - datasource: 14__table - left_margin: auto - linear_color_scheme: schemeYlOrBr - metric: count - normalize_across: heatmap_v2 - row_limit: 10000 - show_legend: true - show_percentage: true - sort_x_axis: alpha_asc - sort_y_axis: alpha_asc - time_range: No filter - url_params: {} - viz_type: heatmap_v2 - xscale_interval: null - value_bounds: - - null - - null - y_axis_format: SMART_NUMBER - yscale_interval: null cache_timeout: null -uuid: cd111331-d286-4258-9020-c7949a109ed2 +certification_details: null +certified_by: null +dataset_uuid: a46c986d-8780-4745-91ff-7fefeef69f3c +description: null +params: + color_picker: + a: 1 + b: 0 + g: 255 + r: 14 + datasource: 5__table + granularity_sqla: null + grid_size: 20 + groupby: [] + mapbox_style: https://tile.openstreetmap.org/{z}/{x}/{y}.png + point_radius: Auto + point_radius_fixed: + type: fix + value: 2000 + point_unit: square_m + row_limit: 5000 + size: count + spatial: + latCol: LAT + lonCol: LON + type: latlong + time_grain_sqla: null + time_range: No filter + viewport: + bearing: -4.952916738791771 + latitude: 37.76024135844065 + longitude: -122.41827069521386 + pitch: 4.750411100577438 + zoom: 14.161641703941438 + viz_type: deck_screengrid +query_context: null +slice_name: Deck.gl Screen grid +uuid: f3adb73f-1c57-4a0c-86fb-8b1f81cfc427 version: 1.0.0 -dataset_uuid: 974b7a1c-22ea-49cb-9214-97b7dbd511e0 +viz_type: deck_screengrid diff --git a/superset/examples/deckgl_demo/dashboard.yaml b/superset/examples/deckgl_demo/dashboard.yaml new file mode 100644 index 00000000000..caf514a1b92 --- /dev/null +++ b/superset/examples/deckgl_demo/dashboard.yaml @@ -0,0 +1,160 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +certification_details: null +certified_by: null +css: null +dashboard_title: deck.gl Demo +description: null +metadata: + chart_configuration: {} + color_scheme: '' + color_scheme_domain: [] + cross_filters_enabled: false + default_filters: '{}' + expanded_slices: {} + global_chart_configuration: {} + label_colors: {} + map_label_colors: {} + native_filter_configuration: [] + refresh_frequency: 0 + shared_label_colors: [] + timed_refresh_immune_slices: [] +position: + CHART-201f7715: + children: [] + id: CHART-201f7715 + meta: + chartId: 155 + height: 50 + sliceName: Deck.gl Hexagons + uuid: 7487e265-39d8-4ccd-b8f4-51f8b32ce073 + width: 6 + type: CHART + CHART-2673431d: + children: [] + id: CHART-2673431d + meta: + chartId: 157 + height: 50 + sliceName: Deck.gl Polygons + uuid: 1964e7e3-6836-42f5-9218-026fd194d6c2 + width: 6 + type: CHART + CHART-2b87513c: + children: [] + id: CHART-2b87513c + meta: + chartId: 159 + height: 50 + sliceName: Deck.gl Path + uuid: e871563b-6b80-4629-b606-ab9054da1fbf + width: 6 + type: CHART + CHART-2ee7fa5e: + children: [] + id: CHART-2ee7fa5e + meta: + chartId: 154 + height: 50 + sliceName: Deck.gl Screen grid + uuid: f3adb73f-1c57-4a0c-86fb-8b1f81cfc427 + width: 6 + type: CHART + CHART-3afd9d70: + children: [] + id: CHART-3afd9d70 + meta: + chartId: 153 + height: 50 + sliceName: Deck.gl Scatterplot + uuid: 36706f55-dec0-46d8-9dab-50842690d8d8 + width: 6 + type: CHART + CHART-85265a60: + children: [] + id: CHART-85265a60 + meta: + chartId: 158 + height: 50 + sliceName: Deck.gl Arcs + uuid: 8663e6d2-5589-49f6-889a-335e8dc15119 + width: 6 + type: CHART + CHART-d02f6c40: + children: [] + id: CHART-d02f6c40 + meta: + chartId: 156 + height: 50 + sliceName: Deck.gl Grid + uuid: 5a42df97-80a7-49ee-8985-fcb7fc0bf281 + width: 6 + type: CHART + DASHBOARD_VERSION_KEY: v2 + GRID_ID: + children: + - ROW-a7b16cb5 + - ROW-72c218a5 + - ROW-957ba55b + - ROW-af041bdd + id: GRID_ID + type: GRID + HEADER_ID: + id: HEADER_ID + meta: + text: deck.gl Demo + type: HEADER + ROOT_ID: + children: + - GRID_ID + id: ROOT_ID + type: ROOT + ROW-72c218a5: + children: + - CHART-d02f6c40 + - CHART-201f7715 + id: ROW-72c218a5 + meta: + background: BACKGROUND_TRANSPARENT + type: ROW + ROW-957ba55b: + children: + - CHART-2673431d + - CHART-85265a60 + id: ROW-957ba55b + meta: + background: BACKGROUND_TRANSPARENT + type: ROW + ROW-a7b16cb5: + children: + - CHART-3afd9d70 + - CHART-2ee7fa5e + id: ROW-a7b16cb5 + meta: + background: BACKGROUND_TRANSPARENT + type: ROW + ROW-af041bdd: + children: + - CHART-2b87513c + id: ROW-af041bdd + meta: + background: BACKGROUND_TRANSPARENT + type: ROW +published: true +slug: deck +uuid: aec4bc9e-0502-40b6-a189-850cd630410d +version: 1.0.0 diff --git a/superset/examples/deckgl_demo/data/bart_lines.parquet b/superset/examples/deckgl_demo/data/bart_lines.parquet new file mode 100644 index 00000000000..975d191391b Binary files /dev/null and b/superset/examples/deckgl_demo/data/bart_lines.parquet differ diff --git a/superset/examples/deckgl_demo/data/flights.parquet b/superset/examples/deckgl_demo/data/flights.parquet new file mode 100644 index 00000000000..1a8d97c11ed Binary files /dev/null and b/superset/examples/deckgl_demo/data/flights.parquet differ diff --git a/superset/examples/deckgl_demo/data/long_lat.parquet b/superset/examples/deckgl_demo/data/long_lat.parquet new file mode 100644 index 00000000000..a553d5c0576 Binary files /dev/null and b/superset/examples/deckgl_demo/data/long_lat.parquet differ diff --git a/superset/examples/deckgl_demo/data/sf_population_polygons.parquet b/superset/examples/deckgl_demo/data/sf_population_polygons.parquet new file mode 100644 index 00000000000..ffdb6b165b3 Binary files /dev/null and b/superset/examples/deckgl_demo/data/sf_population_polygons.parquet differ diff --git a/superset/examples/deckgl_demo/datasets/bart_lines.yaml b/superset/examples/deckgl_demo/datasets/bart_lines.yaml new file mode 100644 index 00000000000..240510f31d1 --- /dev/null +++ b/superset/examples/deckgl_demo/datasets/bart_lines.yaml @@ -0,0 +1,96 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +always_filter_main_dttm: false +cache_timeout: null +catalog: null +columns: +- advanced_data_type: null + column_name: name + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: color + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: path_json + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: polyline + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +data_file: bart_lines.parquet +database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee +default_endpoint: null +description: BART lines +extra: null +fetch_values_predicate: null +filter_select_enabled: true +folders: null +main_dttm_col: null +metrics: +- currency: null + d3format: null + description: null + expression: COUNT(*) + extra: null + metric_name: count + metric_type: count + verbose_name: COUNT(*) + warning_text: null +normalize_columns: false +offset: 0 +params: null +schema: null +sql: null +table_name: bart_lines +template_params: null +uuid: 56a8f963-1298-42a5-99d8-24fd90ab012d +version: 1.0.0 diff --git a/superset/examples/deckgl_demo/datasets/flights.yaml b/superset/examples/deckgl_demo/datasets/flights.yaml new file mode 100644 index 00000000000..78908a6868d --- /dev/null +++ b/superset/examples/deckgl_demo/datasets/flights.yaml @@ -0,0 +1,576 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +always_filter_main_dttm: false +cache_timeout: null +catalog: null +columns: +- advanced_data_type: null + column_name: YEAR + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: MONTH + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: DAY + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: DAY_OF_WEEK + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: AIRLINE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: FLIGHT_NUMBER + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: TAIL_NUMBER + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: ORIGIN_AIRPORT + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: DESTINATION_AIRPORT + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: SCHEDULED_DEPARTURE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: DEPARTURE_TIME + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: DEPARTURE_DELAY + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: TAXI_OUT + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: WHEELS_OFF + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SCHEDULED_TIME + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: ELAPSED_TIME + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: AIR_TIME + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: DISTANCE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: WHEELS_ON + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: TAXI_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SCHEDULED_ARRIVAL + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: ARRIVAL_TIME + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: ARRIVAL_DELAY + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: DIVERTED + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: CANCELLED + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: CANCELLATION_REASON + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: AIR_SYSTEM_DELAY + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SECURITY_DELAY + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: AIRLINE_DELAY + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: LATE_AIRCRAFT_DELAY + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: WEATHER_DELAY + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: ds + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: true + python_date_format: null + type: TIMESTAMP WITHOUT TIME ZONE + verbose_name: null +- advanced_data_type: null + column_name: AIRPORT + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: CITY + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: STATE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: COUNTRY + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: LATITUDE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: LONGITUDE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: AIRPORT_DEST + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: CITY_DEST + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: STATE_DEST + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: COUNTRY_DEST + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: LATITUDE_DEST + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: LONGITUDE_DEST + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +data_file: flights.parquet +database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee +default_endpoint: null +description: Random set of flights in the US +extra: null +fetch_values_predicate: null +filter_select_enabled: true +folders: null +main_dttm_col: ds +metrics: +- currency: null + d3format: null + description: null + expression: COUNT(*) + extra: null + metric_name: count + metric_type: count + verbose_name: COUNT(*) + warning_text: null +normalize_columns: false +offset: 0 +params: null +schema: null +sql: null +table_name: flights +template_params: null +uuid: b474edce-88e2-4ac4-be63-272a9f1dabe7 +version: 1.0.0 diff --git a/superset/examples/configs/datasets/examples/covid_vaccines.yaml b/superset/examples/deckgl_demo/datasets/long_lat.yaml similarity index 58% rename from superset/examples/configs/datasets/examples/covid_vaccines.yaml rename to superset/examples/deckgl_demo/datasets/long_lat.yaml index e5f5ca1b528..46996f664b1 100644 --- a/superset/examples/configs/datasets/examples/covid_vaccines.yaml +++ b/superset/examples/deckgl_demo/datasets/long_lat.yaml @@ -14,194 +14,215 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -table_name: covid_vaccines -main_dttm_col: null -description: null -default_endpoint: null -offset: 0 +always_filter_main_dttm: false cache_timeout: null -schema: null -sql: '' -params: null -template_params: null -filter_select_enabled: true -fetch_values_predicate: null -extra: null -uuid: 974b7a1c-22ea-49cb-9214-97b7dbd511e0 -metrics: -- metric_name: count - verbose_name: COUNT(*) - metric_type: null - expression: COUNT(*) - description: null - d3format: null - extra: null - warning_text: null +catalog: null columns: -- column_name: clinical_stage - verbose_name: null - is_dttm: null - is_active: null - type: STRING - groupby: true - filterable: true - expression: "CASE \nWHEN stage_of_development = 'Pre-clinical' THEN '0. Pre-clinical'\n\ - WHEN stage_of_development = 'Phase I' THEN '1. Phase I' \nWHEN stage_of_development\ - \ = 'Phase I/II' or stage_of_development = 'Phase II' THEN '2. Phase II or\ - \ Combined I/II'\nWHEN stage_of_development = 'Phase III' THEN '3. Phase III'\n\ - WHEN stage_of_development = 'Authorized' THEN '4. Authorized'\nEND" +- advanced_data_type: null + column_name: LON description: null - python_date_format: null -- column_name: fda_approved_indications - verbose_name: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null python_date_format: null -- column_name: anticipated_next_steps + type: FLOAT verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null +- advanced_data_type: null + column_name: LAT description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false python_date_format: null -- column_name: ioc_country_code + type: FLOAT verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null +- advanced_data_type: null + column_name: NUMBER description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false python_date_format: null -- column_name: clinical_trials_for_other_diseases_or_related_use + type: VARCHAR verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null +- advanced_data_type: null + column_name: STREET description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false python_date_format: null -- column_name: country_name + type: VARCHAR verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null +- advanced_data_type: null + column_name: UNIT description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false python_date_format: null -- column_name: product_category + type: VARCHAR verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null +- advanced_data_type: null + column_name: CITY description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false python_date_format: null -- column_name: clinical_trials + type: FLOAT verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null +- advanced_data_type: null + column_name: DISTRICT description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false python_date_format: null -- column_name: date_last_updated + type: FLOAT verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null +- advanced_data_type: null + column_name: REGION description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false python_date_format: null -- column_name: product_description + type: FLOAT verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null +- advanced_data_type: null + column_name: POSTCODE description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false python_date_format: null -- column_name: developer_or_researcher + type: BIGINT verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null +- advanced_data_type: null + column_name: ID description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false python_date_format: null -- column_name: stage_of_development + type: FLOAT verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null +- advanced_data_type: null + column_name: datetime description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: true python_date_format: null -- column_name: funder + type: TIMESTAMP WITHOUT TIME ZONE verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null +- advanced_data_type: null + column_name: occupancy description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false python_date_format: null -- column_name: published_results + type: FLOAT verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null +- advanced_data_type: null + column_name: radius_miles description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false python_date_format: null -- column_name: sources + type: FLOAT verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null +- advanced_data_type: null + column_name: geohash description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false python_date_format: null -- column_name: treatment_vs_vaccine + type: VARCHAR verbose_name: null - is_dttm: false - is_active: null - type: TEXT - groupby: true - filterable: true - expression: null +- advanced_data_type: null + column_name: delimited description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false python_date_format: null -version: 1.0.0 + type: VARCHAR + verbose_name: null +data_file: long_lat.parquet database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee -data: examples://datasets/examples/covid_vaccines.csv +default_endpoint: null +description: null +extra: null +fetch_values_predicate: null +filter_select_enabled: true +folders: null +main_dttm_col: datetime +metrics: +- currency: null + d3format: null + description: null + expression: COUNT(*) + extra: null + metric_name: count + metric_type: count + verbose_name: COUNT(*) + warning_text: null +normalize_columns: false +offset: 0 +params: null +schema: null +sql: null +table_name: long_lat +template_params: null +uuid: a46c986d-8780-4745-91ff-7fefeef69f3c +version: 1.0.0 diff --git a/superset/examples/deckgl_demo/datasets/sf_population_polygons.yaml b/superset/examples/deckgl_demo/datasets/sf_population_polygons.yaml new file mode 100644 index 00000000000..dd8003325b5 --- /dev/null +++ b/superset/examples/deckgl_demo/datasets/sf_population_polygons.yaml @@ -0,0 +1,96 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +always_filter_main_dttm: false +cache_timeout: null +catalog: null +columns: +- advanced_data_type: null + column_name: zipcode + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: population + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: area + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: contour + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +data_file: sf_population_polygons.parquet +database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee +default_endpoint: null +description: Population density of San Francisco +extra: null +fetch_values_predicate: null +filter_select_enabled: true +folders: null +main_dttm_col: null +metrics: +- currency: null + d3format: null + description: null + expression: COUNT(*) + extra: null + metric_name: count + metric_type: count + verbose_name: COUNT(*) + warning_text: null +normalize_columns: false +offset: 0 +params: null +schema: null +sql: null +table_name: sf_population_polygons +template_params: null +uuid: c8f4035a-0771-4f93-b204-9b9581c555ec +version: 1.0.0 diff --git a/superset/examples/energy.py b/superset/examples/energy.py deleted file mode 100644 index 67d6cc5854e..00000000000 --- a/superset/examples/energy.py +++ /dev/null @@ -1,147 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -import logging -import textwrap - -from sqlalchemy import Float, inspect, String -from sqlalchemy.sql import column - -import superset.utils.database as database_utils -from superset import db -from superset.connectors.sqla.models import SqlMetric -from superset.models.slice import Slice -from superset.sql.parse import Table -from superset.utils.core import DatasourceType - -from .helpers import ( - get_slice_json, - get_table_connector_registry, - merge_slice, - misc_dash_slices, - read_example_data, -) - -logger = logging.getLogger(__name__) - - -def load_energy( - only_metadata: bool = False, force: bool = False, sample: bool = False -) -> None: - """Loads an energy related dataset to use with sankey and graphs""" - tbl_name = "energy_usage" - database = database_utils.get_example_database() - - with database.get_sqla_engine() as engine: - schema = inspect(engine).default_schema_name - table_exists = database.has_table(Table(tbl_name, schema)) - - if not only_metadata and (not table_exists or force): - pdf = read_example_data("examples://energy.json.gz", compression="gzip") - pdf = pdf.head(100) if sample else pdf - pdf.to_sql( - tbl_name, - engine, - schema=schema, - if_exists="replace", - chunksize=500, - dtype={"source": String(255), "target": String(255), "value": Float()}, - index=False, - method="multi", - ) - - logger.debug("Creating table [wb_health_population] reference") - table = get_table_connector_registry() - tbl = db.session.query(table).filter_by(table_name=tbl_name).first() - if not tbl: - tbl = table(table_name=tbl_name, schema=schema) - db.session.add(tbl) - tbl.description = "Energy consumption" - tbl.database = database - tbl.filter_select_enabled = True - - if not any(col.metric_name == "sum__value" for col in tbl.metrics): - col = str(column("value").compile(db.engine)) - tbl.metrics.append( - SqlMetric(metric_name="sum__value", expression=f"SUM({col})") - ) - - tbl.fetch_metadata() - - slc = Slice( - slice_name="Energy Sankey", - viz_type="sankey_v2", - datasource_type=DatasourceType.TABLE, - datasource_id=tbl.id, - params=textwrap.dedent( - """\ - { - "collapsed_fieldsets": "", - "source": "source", - "target": "target", - "metric": "sum__value", - "row_limit": "5000", - "slice_name": "Energy Sankey", - "viz_type": "sankey_v2" - } - """ - ), - ) - misc_dash_slices.add(slc.slice_name) - merge_slice(slc) - - slc = Slice( - slice_name="Energy Force Layout", - viz_type="graph_chart", - datasource_type=DatasourceType.TABLE, - datasource_id=tbl.id, - params=textwrap.dedent( - """\ - { - "source": "source", - "target": "target", - "edgeLength": 400, - "repulsion": 1000, - "layout": "force", - "metric": "sum__value", - "row_limit": "5000", - "slice_name": "Force", - "viz_type": "graph_chart" - } - """ - ), - ) - misc_dash_slices.add(slc.slice_name) - merge_slice(slc) - - slc = Slice( - slice_name="Heatmap", - viz_type="heatmap_v2", - datasource_type=DatasourceType.TABLE, - datasource_id=tbl.id, - params=get_slice_json( - defaults={}, - viz_type="heatmap_v2", - x_axis="source", - groupby="target", - legend_type="continuous", - metric="sum__value", - sort_x_axis="value_asc", - sort_y_axis="value_asc", - ), - ) - misc_dash_slices.add(slc.slice_name) - merge_slice(slc) diff --git a/superset/examples/configs/charts/FCC New Coder Survey/Age_distribution_of_respondents.yaml b/superset/examples/fcc_new_coder_survey/charts/Age_distribution_of_respondents.yaml similarity index 90% rename from superset/examples/configs/charts/FCC New Coder Survey/Age_distribution_of_respondents.yaml rename to superset/examples/fcc_new_coder_survey/charts/Age_distribution_of_respondents.yaml index 2e31dde304a..6328ed8fd1c 100644 --- a/superset/examples/configs/charts/FCC New Coder Survey/Age_distribution_of_respondents.yaml +++ b/superset/examples/fcc_new_coder_survey/charts/Age_distribution_of_respondents.yaml @@ -14,23 +14,28 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Age distribution of respondents -viz_type: histogram_v2 +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +description: null params: adhoc_filters: [] - column: age + annotation_layers: [] color_scheme: supersetColors + column: age datasource: 42__table groupby: [] label_colors: {} - link_length: "25" + link_length: '25' row_limit: 10000 slice_id: 1380 url_params: {} viz_type: histogram_v2 x_axis_title: age y_axis_title: count -cache_timeout: null +query_context: null +slice_name: Age distribution of respondents uuid: 5f1ea868-604e-f69d-a241-5daa83ff33be version: 1.0.0 -dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +viz_type: histogram_v2 diff --git a/superset/examples/configs/charts/FCC New Coder Survey/Are_you_an_ethnic_minority_in_your_city.yaml b/superset/examples/fcc_new_coder_survey/charts/Are_you_an_ethnic_minority_in_your_city.yaml similarity index 93% rename from superset/examples/configs/charts/FCC New Coder Survey/Are_you_an_ethnic_minority_in_your_city.yaml rename to superset/examples/fcc_new_coder_survey/charts/Are_you_an_ethnic_minority_in_your_city.yaml index 926de70f92b..e6989ced5f5 100644 --- a/superset/examples/configs/charts/FCC New Coder Survey/Are_you_an_ethnic_minority_in_your_city.yaml +++ b/superset/examples/fcc_new_coder_survey/charts/Are_you_an_ethnic_minority_in_your_city.yaml @@ -14,10 +14,14 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Are you an ethnic minority in your city? -viz_type: pie +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +description: null params: adhoc_filters: [] + annotation_layers: [] color_scheme: supersetColors datasource: 42__table donut: true @@ -26,11 +30,11 @@ params: - ethnic_minority innerRadius: 44 label_line: true + label_type: key labels_outside: true metric: count number_format: SMART_NUMBER outerRadius: 69 - label_type: key queryFields: groupby: groupby metric: metrics @@ -41,7 +45,8 @@ params: time_range: No filter url_params: {} viz_type: pie -cache_timeout: null +query_context: null +slice_name: Are you an ethnic minority in your city? uuid: def07750-b5c0-0b69-6228-cb2330916166 version: 1.0.0 -dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +viz_type: pie diff --git a/superset/examples/configs/charts/FCC New Coder Survey/Breakdown_of_Developer_Type.yaml b/superset/examples/fcc_new_coder_survey/charts/Breakdown_of_Developer_Type.yaml similarity index 93% rename from superset/examples/configs/charts/FCC New Coder Survey/Breakdown_of_Developer_Type.yaml rename to superset/examples/fcc_new_coder_survey/charts/Breakdown_of_Developer_Type.yaml index 83c659aa5f6..514761bc5e6 100644 --- a/superset/examples/configs/charts/FCC New Coder Survey/Breakdown_of_Developer_Type.yaml +++ b/superset/examples/fcc_new_coder_survey/charts/Breakdown_of_Developer_Type.yaml @@ -14,11 +14,15 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Breakdown of Developer Type -viz_type: table +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +description: null params: adhoc_filters: [] all_columns: [] + annotation_layers: [] color_pn: true datasource: 42__table granularity_sqla: time_start @@ -41,7 +45,8 @@ params: time_range: No filter url_params: {} viz_type: table -cache_timeout: null +query_context: null +slice_name: Breakdown of Developer Type uuid: b8386be8-f44e-6535-378c-2aa2ba461286 version: 1.0.0 -dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +viz_type: table diff --git a/superset/examples/configs/charts/FCC New Coder Survey/Commute_Time.yaml b/superset/examples/fcc_new_coder_survey/charts/Commute_Time.yaml similarity index 68% rename from superset/examples/configs/charts/FCC New Coder Survey/Commute_Time.yaml rename to superset/examples/fcc_new_coder_survey/charts/Commute_Time.yaml index 73d13ddab54..9d4990529fc 100644 --- a/superset/examples/configs/charts/FCC New Coder Survey/Commute_Time.yaml +++ b/superset/examples/fcc_new_coder_survey/charts/Commute_Time.yaml @@ -14,33 +14,37 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Commute Time -viz_type: treemap_v2 +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +description: null params: adhoc_filters: - - clause: WHERE - comparator: Currently A Developer - expressionType: SIMPLE - filterOptionName: filter_fvi0jg9aii_2lekqrhy7qk - isExtra: false - isNew: false - operator: == - sqlExpression: null - subject: developer_type - - clause: WHERE - comparator: "NULL" - expressionType: SIMPLE - filterOptionName: filter_r5execgs1q8_hbav07lele - isExtra: false - isNew: false - operator: "!=" - sqlExpression: null - subject: communite_time + - clause: WHERE + comparator: Currently A Developer + expressionType: SIMPLE + filterOptionName: filter_fvi0jg9aii_2lekqrhy7qk + isExtra: false + isNew: false + operator: == + sqlExpression: null + subject: developer_type + - clause: WHERE + comparator: 'NULL' + expressionType: SIMPLE + filterOptionName: filter_r5execgs1q8_hbav07lele + isExtra: false + isNew: false + operator: '!=' + sqlExpression: null + subject: communite_time + annotation_layers: [] color_scheme: supersetColors datasource: 42__table granularity_sqla: time_start groupby: - - communite_time + - communite_time label_colors: {} metric: count number_format: SMART_NUMBER @@ -52,7 +56,8 @@ params: treemap_ratio: 1.618033988749895 url_params: {} viz_type: treemap_v2 -cache_timeout: null +query_context: null +slice_name: Commute Time uuid: 097c05c9-2dd2-481d-813d-d6c0c12b4a3d version: 1.0.0 -dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +viz_type: treemap_v2 diff --git a/superset/examples/configs/charts/FCC New Coder Survey/Country_of_Citizenship.yaml b/superset/examples/fcc_new_coder_survey/charts/Country_of_Citizenship.yaml similarity index 94% rename from superset/examples/configs/charts/FCC New Coder Survey/Country_of_Citizenship.yaml rename to superset/examples/fcc_new_coder_survey/charts/Country_of_Citizenship.yaml index a5fc6b705c8..560501d2c94 100644 --- a/superset/examples/configs/charts/FCC New Coder Survey/Country_of_Citizenship.yaml +++ b/superset/examples/fcc_new_coder_survey/charts/Country_of_Citizenship.yaml @@ -14,10 +14,14 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Country of Citizenship -viz_type: world_map +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +description: null params: adhoc_filters: [] + annotation_layers: [] color_picker: a: 1 b: 135 @@ -59,7 +63,8 @@ params: time_range: No filter url_params: {} viz_type: world_map -cache_timeout: null +query_context: null +slice_name: Country of Citizenship uuid: 2ba66056-a756-d6a3-aaec-0c243fb7062e version: 1.0.0 -dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +viz_type: world_map diff --git a/superset/examples/configs/charts/FCC New Coder Survey/Current_Developers_Is_this_your_first_development_job.yaml b/superset/examples/fcc_new_coder_survey/charts/Current_Developers_Is_this_your_first_development_job.yaml similarity index 94% rename from superset/examples/configs/charts/FCC New Coder Survey/Current_Developers_Is_this_your_first_development_job.yaml rename to superset/examples/fcc_new_coder_survey/charts/Current_Developers_Is_this_your_first_development_job.yaml index ebe544cc51a..6c9ef075bb2 100644 --- a/superset/examples/configs/charts/FCC New Coder Survey/Current_Developers_Is_this_your_first_development_job.yaml +++ b/superset/examples/fcc_new_coder_survey/charts/Current_Developers_Is_this_your_first_development_job.yaml @@ -14,8 +14,11 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: 'Current Developers: Is this your first development job?' -viz_type: big_number_total +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +description: null params: adhoc_filters: - clause: WHERE @@ -27,6 +30,7 @@ params: operator: == sqlExpression: null subject: developer_type + annotation_layers: [] datasource: 42__table granularity_sqla: time_start header_font_size: 0.4 @@ -57,7 +61,8 @@ params: url_params: {} viz_type: big_number_total y_axis_format: SMART_NUMBER -cache_timeout: null +query_context: null +slice_name: 'Current Developers: Is this your first development job?' uuid: bfe5a8e6-146f-ef59-5e6c-13d519b236a8 version: 1.0.0 -dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +viz_type: big_number_total diff --git a/superset/examples/configs/charts/FCC New Coder Survey/Degrees_vs_Income.yaml b/superset/examples/fcc_new_coder_survey/charts/Degrees_vs_Income.yaml similarity index 94% rename from superset/examples/configs/charts/FCC New Coder Survey/Degrees_vs_Income.yaml rename to superset/examples/fcc_new_coder_survey/charts/Degrees_vs_Income.yaml index c2871a6924e..3f17ca33bd2 100644 --- a/superset/examples/configs/charts/FCC New Coder Survey/Degrees_vs_Income.yaml +++ b/superset/examples/fcc_new_coder_survey/charts/Degrees_vs_Income.yaml @@ -14,8 +14,11 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Degrees vs Income -viz_type: box_plot +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +description: null params: adhoc_filters: - clause: WHERE @@ -36,6 +39,7 @@ params: operator: <= sqlExpression: null subject: last_yr_income + annotation_layers: [] color_scheme: supersetColors columns: [] datasource: 42__table @@ -72,8 +76,9 @@ params: url_params: {} viz_type: box_plot whiskerOptions: Tukey - x_ticks_layout: "45\xB0" -cache_timeout: null + x_ticks_layout: 45° +query_context: null +slice_name: Degrees vs Income uuid: 02f546ae-1bf4-bd26-8bc2-14b9279c8a62 version: 1.0.0 -dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +viz_type: box_plot diff --git a/superset/examples/configs/charts/FCC New Coder Survey/Ethnic_Minority__Gender.yaml b/superset/examples/fcc_new_coder_survey/charts/Ethnic_Minority_Gender.yaml similarity index 69% rename from superset/examples/configs/charts/FCC New Coder Survey/Ethnic_Minority__Gender.yaml rename to superset/examples/fcc_new_coder_survey/charts/Ethnic_Minority_Gender.yaml index 59492c61466..67160602993 100644 --- a/superset/examples/configs/charts/FCC New Coder Survey/Ethnic_Minority__Gender.yaml +++ b/superset/examples/fcc_new_coder_survey/charts/Ethnic_Minority_Gender.yaml @@ -14,43 +14,48 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Ethnic Minority & Gender -viz_type: sankey_v2 +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +description: null params: adhoc_filters: - - clause: WHERE - comparator: "NULL" - expressionType: SIMPLE - filterOptionName: filter_of9xf5uks2_5pisp1se9r5 - isExtra: false - isNew: false - operator: "!=" - sqlExpression: null - subject: ethnic_minority - - clause: WHERE - comparator: "NULL" - expressionType: SIMPLE - filterOptionName: filter_9ikn7htywfm_2579he7pk5x - isExtra: false - isNew: false - operator: "!=" - sqlExpression: null - subject: gender + - clause: WHERE + comparator: 'NULL' + expressionType: SIMPLE + filterOptionName: filter_of9xf5uks2_5pisp1se9r5 + isExtra: false + isNew: false + operator: '!=' + sqlExpression: null + subject: ethnic_minority + - clause: WHERE + comparator: 'NULL' + expressionType: SIMPLE + filterOptionName: filter_9ikn7htywfm_2579he7pk5x + isExtra: false + isNew: false + operator: '!=' + sqlExpression: null + subject: gender + annotation_layers: [] color_scheme: supersetColors datasource: 42__table granularity_sqla: time_start - source: ethnic_minority - target: gender label_colors: {} metric: count queryFields: groupby: groupby metric: metrics row_limit: null + source: ethnic_minority + target: gender time_range: No filter url_params: {} viz_type: sankey_v2 -cache_timeout: null +query_context: null +slice_name: Ethnic Minority & Gender uuid: 4880e4f4-b701-4be0-86f3-e7e89432e83b version: 1.0.0 -dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +viz_type: sankey_v2 diff --git a/superset/examples/configs/charts/FCC New Coder Survey/First_Time_Developer.yaml b/superset/examples/fcc_new_coder_survey/charts/First_Time_Developer.yaml similarity index 93% rename from superset/examples/configs/charts/FCC New Coder Survey/First_Time_Developer.yaml rename to superset/examples/fcc_new_coder_survey/charts/First_Time_Developer.yaml index 98070520d23..f5ea9181a14 100644 --- a/superset/examples/configs/charts/FCC New Coder Survey/First_Time_Developer.yaml +++ b/superset/examples/fcc_new_coder_survey/charts/First_Time_Developer.yaml @@ -14,8 +14,11 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: First Time Developer? -viz_type: pie +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +description: null params: adhoc_filters: - clause: WHERE @@ -27,6 +30,7 @@ params: operator: == sqlExpression: null subject: developer_type + annotation_layers: [] color_scheme: supersetColors datasource: 42__table donut: true @@ -34,11 +38,11 @@ params: groupby: - first_time_developer innerRadius: 43 + label_type: key labels_outside: true metric: count number_format: SMART_NUMBER outerRadius: 69 - label_type: key queryFields: groupby: groupby metric: metrics @@ -49,7 +53,8 @@ params: time_range: No filter url_params: {} viz_type: pie -cache_timeout: null +query_context: null +slice_name: First Time Developer? uuid: edc75073-8f33-4123-a28d-cd6dfb33cade version: 1.0.0 -dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +viz_type: pie diff --git a/superset/examples/configs/charts/FCC New Coder Survey/First_Time_Developer__Commute_Time.yaml b/superset/examples/fcc_new_coder_survey/charts/First_Time_Developer_Commute_Time.yaml similarity index 62% rename from superset/examples/configs/charts/FCC New Coder Survey/First_Time_Developer__Commute_Time.yaml rename to superset/examples/fcc_new_coder_survey/charts/First_Time_Developer_Commute_Time.yaml index 40852776f9b..075bd0281f5 100644 --- a/superset/examples/configs/charts/FCC New Coder Survey/First_Time_Developer__Commute_Time.yaml +++ b/superset/examples/fcc_new_coder_survey/charts/First_Time_Developer_Commute_Time.yaml @@ -14,52 +14,57 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: First Time Developer & Commute Time -viz_type: sankey_v2 +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +description: null params: adhoc_filters: - - clause: WHERE - comparator: "1" - expressionType: SIMPLE - filterOptionName: filter_9hkcdqhiqor_84pk01t2k9 - isExtra: false - isNew: false - operator: == - sqlExpression: null - subject: is_software_dev - - clause: WHERE - comparator: "NULL" - expressionType: SIMPLE - filterOptionName: filter_d5l1qwsthl_okyuouvmors - isExtra: false - isNew: false - operator: "!=" - sqlExpression: null - subject: first_time_developer - - clause: WHERE - comparator: "NULL" - expressionType: SIMPLE - filterOptionName: filter_95548uvadi_f990s8nzl4 - isExtra: false - isNew: false - operator: "!=" - sqlExpression: null - subject: communite_time + - clause: WHERE + comparator: '1' + expressionType: SIMPLE + filterOptionName: filter_9hkcdqhiqor_84pk01t2k9 + isExtra: false + isNew: false + operator: == + sqlExpression: null + subject: is_software_dev + - clause: WHERE + comparator: 'NULL' + expressionType: SIMPLE + filterOptionName: filter_d5l1qwsthl_okyuouvmors + isExtra: false + isNew: false + operator: '!=' + sqlExpression: null + subject: first_time_developer + - clause: WHERE + comparator: 'NULL' + expressionType: SIMPLE + filterOptionName: filter_95548uvadi_f990s8nzl4 + isExtra: false + isNew: false + operator: '!=' + sqlExpression: null + subject: communite_time + annotation_layers: [] color_scheme: supersetColors datasource: 42__table granularity_sqla: time_start - source: first_time_developer - target: communite_time label_colors: {} metric: count queryFields: groupby: groupby metric: metrics row_limit: 10000 + source: first_time_developer + target: communite_time time_range: No filter url_params: {} viz_type: sankey_v2 -cache_timeout: null +query_context: null +slice_name: First Time Developer & Commute Time uuid: 067c4a1e-ae03-4c0c-8e2a-d2c0f4bf43c3 version: 1.0.0 -dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +viz_type: sankey_v2 diff --git a/superset/examples/configs/charts/FCC New Coder Survey/Gender.yaml b/superset/examples/fcc_new_coder_survey/charts/Gender.yaml similarity index 92% rename from superset/examples/configs/charts/FCC New Coder Survey/Gender.yaml rename to superset/examples/fcc_new_coder_survey/charts/Gender.yaml index bd584ce717d..9fe6daf9478 100644 --- a/superset/examples/configs/charts/FCC New Coder Survey/Gender.yaml +++ b/superset/examples/fcc_new_coder_survey/charts/Gender.yaml @@ -14,10 +14,14 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Gender -viz_type: pie +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +description: null params: adhoc_filters: [] + annotation_layers: [] color_scheme: supersetColors datasource: 42__table donut: true @@ -26,11 +30,11 @@ params: - gender innerRadius: 44 label_line: true + label_type: key labels_outside: true metric: count number_format: SMART_NUMBER outerRadius: 69 - label_type: key queryFields: groupby: groupby metric: metrics @@ -41,7 +45,8 @@ params: time_range: No filter url_params: {} viz_type: pie -cache_timeout: null +query_context: null +slice_name: Gender uuid: 0f6b447c-828c-e71c-87ac-211bc412b214 version: 1.0.0 -dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +viz_type: pie diff --git a/superset/examples/configs/charts/FCC New Coder Survey/Highest_degree_held.yaml b/superset/examples/fcc_new_coder_survey/charts/Highest_degree_held.yaml similarity index 95% rename from superset/examples/configs/charts/FCC New Coder Survey/Highest_degree_held.yaml rename to superset/examples/fcc_new_coder_survey/charts/Highest_degree_held.yaml index 37cb0d11a1b..80f5e7651d8 100644 --- a/superset/examples/configs/charts/FCC New Coder Survey/Highest_degree_held.yaml +++ b/superset/examples/fcc_new_coder_survey/charts/Highest_degree_held.yaml @@ -14,8 +14,11 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Highest degree held -viz_type: table +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +description: null params: adhoc_filters: - clause: WHERE @@ -28,6 +31,7 @@ params: sqlExpression: null subject: is_software_dev all_columns: [] + annotation_layers: [] color_pn: true datasource: 42__table granularity_sqla: time_start @@ -68,7 +72,8 @@ params: time_range: No filter url_params: {} viz_type: table -cache_timeout: null +query_context: null +slice_name: Highest degree held uuid: 9f7d2b9c-6b3a-69f9-f03e-d3a141514639 version: 1.0.0 -dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +viz_type: table diff --git a/superset/examples/configs/charts/FCC New Coder Survey/How_do_you_prefer_to_work.yaml b/superset/examples/fcc_new_coder_survey/charts/How_do_you_prefer_to_work.yaml similarity index 66% rename from superset/examples/configs/charts/FCC New Coder Survey/How_do_you_prefer_to_work.yaml rename to superset/examples/fcc_new_coder_survey/charts/How_do_you_prefer_to_work.yaml index 55594c52d86..cc129f3fe60 100644 --- a/superset/examples/configs/charts/FCC New Coder Survey/How_do_you_prefer_to_work.yaml +++ b/superset/examples/fcc_new_coder_survey/charts/How_do_you_prefer_to_work.yaml @@ -14,42 +14,45 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: How do you prefer to work? -viz_type: heatmap_v2 +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +description: null params: adhoc_filters: - - clause: WHERE - comparator: "0" - expressionType: SIMPLE - filterOptionName: filter_v65f0j14bk_35oi0g94srk - isExtra: false - isNew: false - operator: == - sqlExpression: null - subject: is_software_dev - - clause: WHERE - comparator: "NULL" - expressionType: SIMPLE - filterOptionName: filter_qb5ionb8wcq_ki4aimey4do - isExtra: false - isNew: false - operator: "!=" - sqlExpression: null - subject: school_degree - - clause: WHERE - comparator: "NULL" - expressionType: SIMPLE - filterOptionName: filter_3n0z71frg5c_xqnl179to7 - isExtra: false - isNew: false - operator: "!=" - sqlExpression: null - subject: job_pref - x_axis: job_pref - groupby: school_degree + - clause: WHERE + comparator: '0' + expressionType: SIMPLE + filterOptionName: filter_v65f0j14bk_35oi0g94srk + isExtra: false + isNew: false + operator: == + sqlExpression: null + subject: is_software_dev + - clause: WHERE + comparator: 'NULL' + expressionType: SIMPLE + filterOptionName: filter_qb5ionb8wcq_ki4aimey4do + isExtra: false + isNew: false + operator: '!=' + sqlExpression: null + subject: school_degree + - clause: WHERE + comparator: 'NULL' + expressionType: SIMPLE + filterOptionName: filter_3n0z71frg5c_xqnl179to7 + isExtra: false + isNew: false + operator: '!=' + sqlExpression: null + subject: job_pref + annotation_layers: [] bottom_margin: auto datasource: 42__table granularity_sqla: time_start + groupby: school_degree left_margin: auto linear_color_scheme: blue_white_yellow metric: count @@ -64,14 +67,16 @@ params: sort_y_axis: alpha_asc time_range: No filter url_params: {} - viz_type: heatmap_v2 - xscale_interval: null value_bounds: - - null - - null + - null + - null + viz_type: heatmap_v2 + x_axis: job_pref + xscale_interval: null y_axis_format: SMART_NUMBER yscale_interval: null -cache_timeout: null +query_context: null +slice_name: How do you prefer to work? uuid: cb8998ab-9f93-4f0f-4e4b-3bfe4b0dea9d version: 1.0.0 -dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +viz_type: heatmap_v2 diff --git a/superset/examples/configs/charts/FCC New Coder Survey/How_much_do_you_expect_to_earn_0_-_100k.yaml b/superset/examples/fcc_new_coder_survey/charts/How_much_do_you_expect_to_earn_0_-_100k.yaml similarity index 66% rename from superset/examples/configs/charts/FCC New Coder Survey/How_much_do_you_expect_to_earn_0_-_100k.yaml rename to superset/examples/fcc_new_coder_survey/charts/How_much_do_you_expect_to_earn_0_-_100k.yaml index 9ec09c8e23e..b2d4e0815ad 100644 --- a/superset/examples/configs/charts/FCC New Coder Survey/How_much_do_you_expect_to_earn_0_-_100k.yaml +++ b/superset/examples/fcc_new_coder_survey/charts/How_much_do_you_expect_to_earn_0_-_100k.yaml @@ -14,38 +14,43 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: How much do you expect to earn? ($0 - 100k) -viz_type: histogram_v2 +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +description: null params: adhoc_filters: - - clause: WHERE - comparator: Aspiring Developer - expressionType: SIMPLE - filterOptionName: filter_dfz5l631lx_lb7f2rlmjdl - isExtra: false - isNew: false - operator: == - sqlExpression: null - subject: developer_type - - clause: WHERE - comparator: "200000" - expressionType: SIMPLE - filterOptionName: filter_6nmi4fk837u_6lvcpn3zzvf - isExtra: false - isNew: false - operator: <= - sqlExpression: null - subject: expected_earn - column: expected_earn + - clause: WHERE + comparator: Aspiring Developer + expressionType: SIMPLE + filterOptionName: filter_dfz5l631lx_lb7f2rlmjdl + isExtra: false + isNew: false + operator: == + sqlExpression: null + subject: developer_type + - clause: WHERE + comparator: '200000' + expressionType: SIMPLE + filterOptionName: filter_6nmi4fk837u_6lvcpn3zzvf + isExtra: false + isNew: false + operator: <= + sqlExpression: null + subject: expected_earn + annotation_layers: [] color_scheme: supersetColors + column: expected_earn datasource: 42__table groupby: [] - link_length: "10" + link_length: '10' row_limit: null slice_id: 1366 url_params: {} viz_type: histogram_v2 -cache_timeout: null +query_context: null +slice_name: How much do you expect to earn? ($0 - 100k) uuid: 6d0ceb30-2008-d19c-d285-cf77dc764433 version: 1.0.0 -dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +viz_type: histogram_v2 diff --git a/superset/examples/configs/charts/FCC New Coder Survey/Last_Year_Income_Distribution.yaml b/superset/examples/fcc_new_coder_survey/charts/Last_Year_Income_Distribution.yaml similarity index 66% rename from superset/examples/configs/charts/FCC New Coder Survey/Last_Year_Income_Distribution.yaml rename to superset/examples/fcc_new_coder_survey/charts/Last_Year_Income_Distribution.yaml index d17dbd38d24..16f20e86536 100644 --- a/superset/examples/configs/charts/FCC New Coder Survey/Last_Year_Income_Distribution.yaml +++ b/superset/examples/fcc_new_coder_survey/charts/Last_Year_Income_Distribution.yaml @@ -14,38 +14,43 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Last Year Income Distribution -viz_type: histogram_v2 +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +description: null params: adhoc_filters: - - clause: WHERE - comparator: Currently A Developer - expressionType: SIMPLE - filterOptionName: filter_fvi0jg9aii_2lekqrhy7qk - isExtra: false - isNew: false - operator: == - sqlExpression: null - subject: developer_type - - clause: WHERE - comparator: "100000" - expressionType: SIMPLE - filterOptionName: filter_khdc3iypzjg_3g6h02b4f2p - isExtra: false - isNew: false - operator: <= - sqlExpression: null - subject: last_yr_income - column: last_yr_income + - clause: WHERE + comparator: Currently A Developer + expressionType: SIMPLE + filterOptionName: filter_fvi0jg9aii_2lekqrhy7qk + isExtra: false + isNew: false + operator: == + sqlExpression: null + subject: developer_type + - clause: WHERE + comparator: '100000' + expressionType: SIMPLE + filterOptionName: filter_khdc3iypzjg_3g6h02b4f2p + isExtra: false + isNew: false + operator: <= + sqlExpression: null + subject: last_yr_income + annotation_layers: [] color_scheme: supersetColors + column: last_yr_income datasource: 42__table groupby: [] label_colors: {} - link_length: "10" + link_length: '10' row_limit: null url_params: {} viz_type: histogram_v2 -cache_timeout: null +query_context: null +slice_name: Last Year Income Distribution uuid: a2ec5256-94b4-43c4-b8c7-b83f70c5d4df version: 1.0.0 -dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +viz_type: histogram_v2 diff --git a/superset/examples/configs/charts/FCC New Coder Survey/Location_of_Current_Developers.yaml b/superset/examples/fcc_new_coder_survey/charts/Location_of_Current_Developers.yaml similarity index 95% rename from superset/examples/configs/charts/FCC New Coder Survey/Location_of_Current_Developers.yaml rename to superset/examples/fcc_new_coder_survey/charts/Location_of_Current_Developers.yaml index 3a05331909d..ead467dac64 100644 --- a/superset/examples/configs/charts/FCC New Coder Survey/Location_of_Current_Developers.yaml +++ b/superset/examples/fcc_new_coder_survey/charts/Location_of_Current_Developers.yaml @@ -14,8 +14,11 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Location of Current Developers -viz_type: world_map +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +description: null params: adhoc_filters: - clause: WHERE @@ -27,6 +30,7 @@ params: operator: == sqlExpression: null subject: is_software_dev + annotation_layers: [] color_picker: a: 1 b: 135 @@ -68,7 +72,8 @@ params: time_range: No filter url_params: {} viz_type: world_map -cache_timeout: null +query_context: null +slice_name: Location of Current Developers uuid: 5596e0f6-78a9-465d-8325-7139c794a06a version: 1.0.0 -dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +viz_type: world_map diff --git a/superset/examples/configs/charts/FCC New Coder Survey/Number_of_Aspiring_Developers.yaml b/superset/examples/fcc_new_coder_survey/charts/Number_of_Aspiring_Developers.yaml similarity index 93% rename from superset/examples/configs/charts/FCC New Coder Survey/Number_of_Aspiring_Developers.yaml rename to superset/examples/fcc_new_coder_survey/charts/Number_of_Aspiring_Developers.yaml index 51c1e42f67c..ed90f4e3df4 100644 --- a/superset/examples/configs/charts/FCC New Coder Survey/Number_of_Aspiring_Developers.yaml +++ b/superset/examples/fcc_new_coder_survey/charts/Number_of_Aspiring_Developers.yaml @@ -14,8 +14,11 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Number of Aspiring Developers -viz_type: big_number_total +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +description: null params: adhoc_filters: - clause: WHERE @@ -27,6 +30,7 @@ params: operator: == sqlExpression: null subject: is_software_dev + annotation_layers: [] datasource: 42__table granularity_sqla: time_start header_font_size: 0.4 @@ -39,7 +43,8 @@ params: url_params: {} viz_type: big_number_total y_axis_format: SMART_NUMBER -cache_timeout: null +query_context: null +slice_name: Number of Aspiring Developers uuid: a0e5329f-224e-6fc8-efd2-d37d0f546ee8 version: 1.0.0 -dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +viz_type: big_number_total diff --git a/superset/examples/configs/charts/FCC New Coder Survey/Preferred_Employment_Style.yaml b/superset/examples/fcc_new_coder_survey/charts/Preferred_Employment_Style.yaml similarity index 70% rename from superset/examples/configs/charts/FCC New Coder Survey/Preferred_Employment_Style.yaml rename to superset/examples/fcc_new_coder_survey/charts/Preferred_Employment_Style.yaml index 9550d3c31d4..5e76858a51a 100644 --- a/superset/examples/configs/charts/FCC New Coder Survey/Preferred_Employment_Style.yaml +++ b/superset/examples/fcc_new_coder_survey/charts/Preferred_Employment_Style.yaml @@ -14,33 +14,37 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Preferred Employment Style -viz_type: treemap_v2 +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +description: null params: adhoc_filters: - - clause: WHERE - comparator: "0" - expressionType: SIMPLE - filterOptionName: filter_s1jzmdwgeg_p3er4w56uy - isExtra: false - isNew: false - operator: == - sqlExpression: null - subject: is_software_dev - - clause: WHERE - comparator: "NULL" - expressionType: SIMPLE - filterOptionName: filter_rdlajraxs0f_lgyfv4rvdh - isExtra: false - isNew: false - operator: "!=" - sqlExpression: null - subject: job_pref + - clause: WHERE + comparator: '0' + expressionType: SIMPLE + filterOptionName: filter_s1jzmdwgeg_p3er4w56uy + isExtra: false + isNew: false + operator: == + sqlExpression: null + subject: is_software_dev + - clause: WHERE + comparator: 'NULL' + expressionType: SIMPLE + filterOptionName: filter_rdlajraxs0f_lgyfv4rvdh + isExtra: false + isNew: false + operator: '!=' + sqlExpression: null + subject: job_pref + annotation_layers: [] color_scheme: supersetColors datasource: 42__table granularity_sqla: time_start groupby: - - job_pref + - job_pref label_colors: {} metric: count number_format: SMART_NUMBER @@ -53,7 +57,8 @@ params: treemap_ratio: 1.618033988749895 url_params: {} viz_type: treemap_v2 -cache_timeout: null +query_context: null +slice_name: Preferred Employment Style uuid: bff88053-ccc4-92f2-d6f5-de83e950e8cd version: 1.0.0 -dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +viz_type: treemap_v2 diff --git a/superset/examples/configs/charts/FCC New Coder Survey/Relocation_ability.yaml b/superset/examples/fcc_new_coder_survey/charts/Relocation_ability.yaml similarity index 91% rename from superset/examples/configs/charts/FCC New Coder Survey/Relocation_ability.yaml rename to superset/examples/fcc_new_coder_survey/charts/Relocation_ability.yaml index 3cec3ce4e20..c7415fff7be 100644 --- a/superset/examples/configs/charts/FCC New Coder Survey/Relocation_ability.yaml +++ b/superset/examples/fcc_new_coder_survey/charts/Relocation_ability.yaml @@ -14,8 +14,11 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: "\u2708\uFE0F Relocation ability" -viz_type: pie +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +description: null params: adhoc_filters: - clause: WHERE @@ -27,6 +30,7 @@ params: operator: == sqlExpression: null subject: is_software_dev + annotation_layers: [] color_scheme: supersetColors datasource: 42__table donut: true @@ -34,11 +38,11 @@ params: groupby: - willing_to_relocate innerRadius: 44 + label_type: key labels_outside: true metric: count number_format: SMART_NUMBER outerRadius: 69 - label_type: key queryFields: groupby: groupby metric: metrics @@ -49,7 +53,8 @@ params: time_range: No filter url_params: {} viz_type: pie -cache_timeout: null +query_context: null +slice_name: ✈️ Relocation ability uuid: a6dd2d5a-2cdc-c8ec-f30c-85920f4f8a65 version: 1.0.0 -dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +viz_type: pie diff --git a/superset/examples/configs/charts/FCC New Coder Survey/Top_15_Languages_Spoken_at_Home.yaml b/superset/examples/fcc_new_coder_survey/charts/Top_15_Languages_Spoken_at_Home.yaml similarity index 93% rename from superset/examples/configs/charts/FCC New Coder Survey/Top_15_Languages_Spoken_at_Home.yaml rename to superset/examples/fcc_new_coder_survey/charts/Top_15_Languages_Spoken_at_Home.yaml index 4143ed4d2e2..1ab4e506461 100644 --- a/superset/examples/configs/charts/FCC New Coder Survey/Top_15_Languages_Spoken_at_Home.yaml +++ b/superset/examples/fcc_new_coder_survey/charts/Top_15_Languages_Spoken_at_Home.yaml @@ -14,8 +14,11 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Top 15 Languages Spoken at Home -viz_type: table +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +description: null params: adhoc_filters: - clause: WHERE @@ -28,6 +31,7 @@ params: sqlExpression: null subject: lang_at_home all_columns: [] + annotation_layers: [] color_pn: true datasource: 42__table granularity_sqla: time_start @@ -50,7 +54,8 @@ params: time_range: No filter url_params: {} viz_type: table -cache_timeout: null +query_context: null +slice_name: Top 15 Languages Spoken at Home uuid: 03a74c97-52fc-cf87-233c-d4275f8c550c version: 1.0.0 -dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +viz_type: table diff --git a/superset/examples/configs/charts/FCC New Coder Survey/Work_Location_Preference.yaml b/superset/examples/fcc_new_coder_survey/charts/Work_Location_Preference.yaml similarity index 93% rename from superset/examples/configs/charts/FCC New Coder Survey/Work_Location_Preference.yaml rename to superset/examples/fcc_new_coder_survey/charts/Work_Location_Preference.yaml index 86bb05623f9..57a0ee1a620 100644 --- a/superset/examples/configs/charts/FCC New Coder Survey/Work_Location_Preference.yaml +++ b/superset/examples/fcc_new_coder_survey/charts/Work_Location_Preference.yaml @@ -14,8 +14,11 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Work Location Preference -viz_type: pie +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +description: null params: adhoc_filters: - clause: WHERE @@ -27,6 +30,7 @@ params: operator: == sqlExpression: null subject: is_software_dev + annotation_layers: [] color_scheme: supersetColors datasource: 42__table donut: true @@ -34,11 +38,11 @@ params: groupby: - job_location_preference innerRadius: 44 + label_type: key labels_outside: true metric: count number_format: SMART_NUMBER outerRadius: 69 - label_type: key queryFields: groupby: groupby metric: metrics @@ -49,7 +53,8 @@ params: time_range: No filter url_params: {} viz_type: pie -cache_timeout: null +query_context: null +slice_name: Work Location Preference uuid: e6b09c28-98cf-785f-4caf-320fd4fca802 version: 1.0.0 -dataset_uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +viz_type: pie diff --git a/superset/examples/configs/dashboards/FCC_New_Coder_Survey_2018.yaml b/superset/examples/fcc_new_coder_survey/dashboard.yaml similarity index 61% rename from superset/examples/configs/dashboards/FCC_New_Coder_Survey_2018.yaml rename to superset/examples/fcc_new_coder_survey/dashboard.yaml index b1508daff0b..4199e8b60b7 100644 --- a/superset/examples/configs/dashboards/FCC_New_Coder_Survey_2018.yaml +++ b/superset/examples/fcc_new_coder_survey/dashboard.yaml @@ -14,398 +14,447 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. +certification_details: '' +certified_by: '' +css: '' dashboard_title: FCC New Coder Survey 2018 description: null -css: "" -slug: null -certified_by: "" -certification_details: "" -published: true -uuid: 5b12b583-8204-08e9-392c-422209c29787 +metadata: + chart_configuration: {} + color_scheme: supersetColors + color_scheme_domain: [] + cross_filters_enabled: false + default_filters: '{}' + expanded_slices: {} + global_chart_configuration: {} + label_colors: + '0': '#FCC700' + '1': '#A868B7' + '15': '#3CCCCB' + '30': '#A38F79' + '45': '#8FD3E4' + : '#5AC189' + Female: '#454E7C' + From Home: '#1FA8C9' + I: '#FEC0A1' + In an Office (with Other Developers): '#9EE5E5' + Less: '#ACE1C4' + Male: '#666666' + More: '#A1A6BD' + 'No': '#666666' + No Answer: '#D3B3DA' + No Preference: '#D1C6BC' + No,: '#FF7F44' + No, not an ethnic minority: '#1FA8C9' + 'No: Not Willing to': '#FDE380' + Ph.D.: '#FCC700' + Prefer: '#5AC189' + Prefer not to say: '#E04355' + 'Yes': '#FF7F44' + Yes,: '#1FA8C9' + Yes, an ethnic minority: '#454E7C' + 'Yes: Willing To': '#EFA1AA' + age: '#1FA8C9' + associate's degree: '#A868B7' + bachelor's degree: '#3CCCCB' + expected_earn: '#B2B2B2' + high school diploma or equivalent (GED): '#A38F79' + last_yr_income: '#E04355' + master's degree (non-professional): '#8FD3E4' + no high school (secondary school): '#A1A6BD' + professional degree (MBA, MD, JD, etc.): '#ACE1C4' + some college credit, no degree: '#FEC0A1' + some high school: '#B2B2B2' + trade, technical, or vocational training: '#EFA1AA' + map_label_colors: {} + native_filter_configuration: [] + refresh_frequency: 0 + shared_label_colors: [] + timed_refresh_immune_slices: [] position: CHART--0GPGmD-pO: children: [] id: CHART--0GPGmD-pO meta: - chartId: 1361 + chartId: 86 height: 56 - sliceName: "Current Developers: Is this your first development job?" + sliceName: 'Current Developers: Is this your first development job?' sliceNameOverride: Is this your first development job? uuid: bfe5a8e6-146f-ef59-5e6c-13d519b236a8 width: 2 parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-l_9I0aNYZ - - ROW-b7USYEngT + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-l_9I0aNYZ + - ROW-b7USYEngT type: CHART CHART--w_Br1tPP3: children: [] id: CHART--w_Br1tPP3 meta: - chartId: 1365 + chartId: 76 height: 51 - sliceName: "\u2708\uFE0F Relocation ability" + sliceName: ✈️ Relocation ability uuid: a6dd2d5a-2cdc-c8ec-f30c-85920f4f8a65 width: 3 parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-YT6eNksV- - - ROW-DR80aHJA2c + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-YT6eNksV- + - ROW-DR80aHJA2c type: CHART CHART-0-zzTwBINh: children: [] id: CHART-0-zzTwBINh meta: - chartId: 3631 + chartId: 75 height: 55 sliceName: Last Year Income Distribution uuid: a2ec5256-94b4-43c4-b8c7-b83f70c5d4df width: 3 parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-l_9I0aNYZ - - ROW-b7USYEngT + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-l_9I0aNYZ + - ROW-b7USYEngT type: CHART CHART-37fu7fO6Z0: children: [] id: CHART-37fu7fO6Z0 meta: - chartId: 1376 + chartId: 85 height: 69 sliceName: Degrees vs Income uuid: 02f546ae-1bf4-bd26-8bc2-14b9279c8a62 width: 7 parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-l_9I0aNYZ - - ROW-kNjtGVFpp + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-l_9I0aNYZ + - ROW-kNjtGVFpp type: CHART CHART-5QwNlSbXYU: children: [] id: CHART-5QwNlSbXYU meta: - chartId: 3633 + chartId: 81 height: 69 sliceName: Commute Time uuid: 097c05c9-2dd2-481d-813d-d6c0c12b4a3d width: 5 parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-l_9I0aNYZ - - ROW-kNjtGVFpp + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-l_9I0aNYZ + - ROW-kNjtGVFpp type: CHART CHART-FKuVqq4kaA: children: [] id: CHART-FKuVqq4kaA meta: - chartId: 1370 + chartId: 77 height: 50 sliceName: Work Location Preference sliceNameOverride: Work Location Preference uuid: e6b09c28-98cf-785f-4caf-320fd4fca802 width: 3 parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-YT6eNksV- - - ROW-DR80aHJA2c + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-YT6eNksV- + - ROW-DR80aHJA2c type: CHART CHART-JnpdZOhVer: children: [] id: CHART-JnpdZOhVer meta: - chartId: 1369 + chartId: 68 height: 50 sliceName: Highest degree held uuid: 9f7d2b9c-6b3a-69f9-f03e-d3a141514639 width: 2 parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-YT6eNksV- - - ROW--BIzjz9F0 - - COLUMN-IEKAo_QJlz + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-YT6eNksV- + - ROW--BIzjz9F0 + - COLUMN-IEKAo_QJlz type: CHART CHART-LjfhrUkEef: children: [] id: CHART-LjfhrUkEef meta: - chartId: 3634 + chartId: 78 height: 68 sliceName: First Time Developer & Commute Time uuid: 067c4a1e-ae03-4c0c-8e2a-d2c0f4bf43c3 width: 5 parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-l_9I0aNYZ - - ROW-s3l4os7YY + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-l_9I0aNYZ + - ROW-s3l4os7YY type: CHART CHART-Q3pbwsH3id: children: [] id: CHART-Q3pbwsH3id meta: - chartId: 1383 + chartId: 74 height: 50 sliceName: Are you an ethnic minority in your city? sliceNameOverride: Minority Status (in their city) uuid: def07750-b5c0-0b69-6228-cb2330916166 width: 3 parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-AsMaxdYL_t - - ROW-mOvr_xWm1 + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-AsMaxdYL_t + - ROW-mOvr_xWm1 type: CHART CHART-QVql08s5Bv: children: [] id: CHART-QVql08s5Bv meta: - chartId: 3632 + chartId: 84 height: 56 sliceName: First Time Developer? uuid: edc75073-8f33-4123-a28d-cd6dfb33cade width: 3 parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-l_9I0aNYZ - - ROW-b7USYEngT + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-l_9I0aNYZ + - ROW-b7USYEngT type: CHART CHART-UtSaz4pfV6: children: [] id: CHART-UtSaz4pfV6 meta: - chartId: 1380 + chartId: 82 height: 50 sliceName: Age distribution of respondents uuid: 5f1ea868-604e-f69d-a241-5daa83ff33be width: 3 parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-AsMaxdYL_t - - ROW-UsW-_RPAb - - COLUMN-OJ5spdMmNh + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-AsMaxdYL_t + - ROW-UsW-_RPAb + - COLUMN-OJ5spdMmNh type: CHART CHART-VvFbGxi3X_: children: [] id: CHART-VvFbGxi3X_ meta: - chartId: 1386 + chartId: 71 height: 62 sliceName: Top 15 Languages Spoken at Home uuid: 03a74c97-52fc-cf87-233c-d4275f8c550c width: 3 parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-AsMaxdYL_t - - ROW-UsW-_RPAb - - COLUMN-OJ5spdMmNh + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-AsMaxdYL_t + - ROW-UsW-_RPAb + - COLUMN-OJ5spdMmNh type: CHART CHART-XHncHuS5pZ: children: [] id: CHART-XHncHuS5pZ meta: - chartId: 1363 + chartId: 79 height: 41 sliceName: Number of Aspiring Developers sliceNameOverride: What type of work would you prefer? uuid: a0e5329f-224e-6fc8-efd2-d37d0f546ee8 width: 2 parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-YT6eNksV- - - ROW-DR80aHJA2c + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-YT6eNksV- + - ROW-DR80aHJA2c type: CHART CHART-YSzS5GOOLf: children: [] id: CHART-YSzS5GOOLf meta: - chartId: 3630 + chartId: 80 height: 54 sliceName: Ethnic Minority & Gender uuid: 4880e4f4-b701-4be0-86f3-e7e89432e83b width: 3 parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-AsMaxdYL_t - - ROW-mOvr_xWm1 + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-AsMaxdYL_t + - ROW-mOvr_xWm1 type: CHART CHART-ZECnzPz8Bi: children: [] id: CHART-ZECnzPz8Bi meta: - chartId: 3635 + chartId: 72 height: 74 sliceName: Location of Current Developers uuid: 5596e0f6-78a9-465d-8325-7139c794a06a width: 7 parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-l_9I0aNYZ - - ROW-s3l4os7YY + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-l_9I0aNYZ + - ROW-s3l4os7YY type: CHART CHART-aytwlT4GAq: children: [] id: CHART-aytwlT4GAq meta: - chartId: 1384 + chartId: 69 height: 30 sliceName: Breakdown of Developer Type uuid: b8386be8-f44e-6535-378c-2aa2ba461286 width: 6 parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-AsMaxdYL_t - - ROW-y-GwJPgxLr + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-AsMaxdYL_t + - ROW-y-GwJPgxLr type: CHART CHART-fLpTSAHpAO: children: [] id: CHART-fLpTSAHpAO meta: - chartId: 1388 + chartId: 87 height: 118 sliceName: Country of Citizenship uuid: 2ba66056-a756-d6a3-aaec-0c243fb7062e width: 9 parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-AsMaxdYL_t - - ROW-UsW-_RPAb + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-AsMaxdYL_t + - ROW-UsW-_RPAb type: CHART CHART-lQVSAw0Or3: children: [] id: CHART-lQVSAw0Or3 meta: - chartId: 1367 + chartId: 83 height: 100 sliceName: How do you prefer to work? sliceNameOverride: Preferred Employment Style vs Degree uuid: cb8998ab-9f93-4f0f-4e4b-3bfe4b0dea9d width: 4 parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-YT6eNksV- - - ROW--BIzjz9F0 + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-YT6eNksV- + - ROW--BIzjz9F0 type: CHART CHART-o-JPAWMZK-: children: [] id: CHART-o-JPAWMZK- meta: - chartId: 1385 + chartId: 70 height: 50 sliceName: Gender uuid: 0f6b447c-828c-e71c-87ac-211bc412b214 width: 3 parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-AsMaxdYL_t - - ROW-mOvr_xWm1 + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-AsMaxdYL_t + - ROW-mOvr_xWm1 type: CHART CHART-v22McUFMtx: children: [] id: CHART-v22McUFMtx meta: - chartId: 1366 + chartId: 67 height: 52 sliceName: How much do you expect to earn? ($0 - 100k) - sliceNameOverride: "\U0001F4B2Expected Income (excluding outliers)" + sliceNameOverride: 💲Expected Income (excluding outliers) uuid: 6d0ceb30-2008-d19c-d285-cf77dc764433 width: 4 parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-YT6eNksV- - - ROW--BIzjz9F0 - - COLUMN-IEKAo_QJlz + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-YT6eNksV- + - ROW--BIzjz9F0 + - COLUMN-IEKAo_QJlz type: CHART CHART-wxWVtlajRF: children: [] id: CHART-wxWVtlajRF meta: - chartId: 1377 + chartId: 73 height: 104 sliceName: Preferred Employment Style uuid: bff88053-ccc4-92f2-d6f5-de83e950e8cd width: 4 parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-YT6eNksV- - - ROW--BIzjz9F0 + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-YT6eNksV- + - ROW--BIzjz9F0 type: CHART COLUMN-IEKAo_QJlz: children: - - CHART-JnpdZOhVer - - CHART-v22McUFMtx + - CHART-JnpdZOhVer + - CHART-v22McUFMtx id: COLUMN-IEKAo_QJlz meta: background: BACKGROUND_TRANSPARENT width: 4 parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-YT6eNksV- - - ROW--BIzjz9F0 + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-YT6eNksV- + - ROW--BIzjz9F0 type: COLUMN COLUMN-OJ5spdMmNh: children: - - CHART-VvFbGxi3X_ - - CHART-UtSaz4pfV6 + - CHART-VvFbGxi3X_ + - CHART-UtSaz4pfV6 id: COLUMN-OJ5spdMmNh meta: background: BACKGROUND_TRANSPARENT width: 3 parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-AsMaxdYL_t - - ROW-UsW-_RPAb + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-AsMaxdYL_t + - ROW-UsW-_RPAb type: COLUMN DASHBOARD_VERSION_KEY: v2 GRID_ID: children: - - TABS-L-d9eyOE-b + - TABS-L-d9eyOE-b id: GRID_ID parents: - - ROOT_ID + - ROOT_ID type: GRID HEADER_ID: id: HEADER_ID @@ -439,21 +488,21 @@ position: height: 50 width: 4 parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-YT6eNksV- - - ROW-DR80aHJA2c + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-YT6eNksV- + - ROW-DR80aHJA2c type: MARKDOWN MARKDOWN-NQmSPDOtpl: children: [] id: MARKDOWN-NQmSPDOtpl meta: - code: "# Current Developers + code: '# Current Developers - While majority of the students on FCC are Aspiring developers, there's a - nontrivial minority that's there to continue leveling up their skills (17% + While majority of the students on FCC are Aspiring developers, there''s a + nontrivial minority that''s there to continue leveling up their skills (17% of the survey respondents). @@ -466,28 +515,28 @@ position: - The proportion of developers whose current job is their first developer job - - Distribution of last year's income + - Distribution of last year''s income - The geographic distribution of these developers - The overlap between commute time and if their current job is their first developer job - - Potential link between highest degree earned and last year's income" + - Potential link between highest degree earned and last year''s income' height: 56 width: 4 parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-l_9I0aNYZ - - ROW-b7USYEngT + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-l_9I0aNYZ + - ROW-b7USYEngT type: MARKDOWN MARKDOWN-__u6CsUyfh: children: [] id: MARKDOWN-__u6CsUyfh meta: - code: "## FreeCodeCamp New Coder Survey 2018 + code: '## FreeCodeCamp New Coder Survey 2018 Every year, FCC surveys its user base (mostly budding software developers) @@ -499,22 +548,21 @@ position: - [Dataset](https://github.com/freeCodeCamp/2018-new-coder-survey) - - [FCC Blog Post](https://www.freecodecamp.org/news/we-asked-20-000-people-who-they-are-and-how-theyre-learning-to-code-fff5d668969/)" + - [FCC Blog Post](https://www.freecodecamp.org/news/we-asked-20-000-people-who-they-are-and-how-theyre-learning-to-code-fff5d668969/)' height: 30 width: 6 parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-AsMaxdYL_t - - ROW-y-GwJPgxLr + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-AsMaxdYL_t + - ROW-y-GwJPgxLr type: MARKDOWN MARKDOWN-zc2mWxZeox: children: [] id: MARKDOWN-zc2mWxZeox meta: - code: - "# Demographics\n\nFreeCodeCamp is a completely-online community of people\ + code: "# Demographics\n\nFreeCodeCamp is a completely-online community of people\ \ learning to code and consists of aspiring & current developers from all\ \ over the world. That doesn't necessarily mean that access to these types\ \ of opportunities are evenly distributed. \n\nThe following charts can begin\ @@ -524,220 +572,178 @@ position: height: 52 width: 3 parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-AsMaxdYL_t - - ROW-mOvr_xWm1 + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-AsMaxdYL_t + - ROW-mOvr_xWm1 type: MARKDOWN ROOT_ID: children: - - GRID_ID + - GRID_ID id: ROOT_ID type: ROOT ROW--BIzjz9F0: children: - - COLUMN-IEKAo_QJlz - - CHART-lQVSAw0Or3 - - CHART-wxWVtlajRF + - COLUMN-IEKAo_QJlz + - CHART-lQVSAw0Or3 + - CHART-wxWVtlajRF id: ROW--BIzjz9F0 meta: background: BACKGROUND_TRANSPARENT parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-YT6eNksV- + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-YT6eNksV- type: ROW ROW-DR80aHJA2c: children: - - MARKDOWN-BUmyHM2s0x - - CHART-XHncHuS5pZ - - CHART--w_Br1tPP3 - - CHART-FKuVqq4kaA + - MARKDOWN-BUmyHM2s0x + - CHART-XHncHuS5pZ + - CHART--w_Br1tPP3 + - CHART-FKuVqq4kaA id: ROW-DR80aHJA2c meta: background: BACKGROUND_TRANSPARENT parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-YT6eNksV- + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-YT6eNksV- type: ROW ROW-UsW-_RPAb: children: - - COLUMN-OJ5spdMmNh - - CHART-fLpTSAHpAO + - COLUMN-OJ5spdMmNh + - CHART-fLpTSAHpAO id: ROW-UsW-_RPAb meta: background: BACKGROUND_TRANSPARENT parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-AsMaxdYL_t + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-AsMaxdYL_t type: ROW ROW-b7USYEngT: children: - - MARKDOWN-NQmSPDOtpl - - CHART--0GPGmD-pO - - CHART-QVql08s5Bv - - CHART-0-zzTwBINh + - MARKDOWN-NQmSPDOtpl + - CHART--0GPGmD-pO + - CHART-QVql08s5Bv + - CHART-0-zzTwBINh id: ROW-b7USYEngT meta: background: BACKGROUND_TRANSPARENT parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-l_9I0aNYZ + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-l_9I0aNYZ type: ROW ROW-kNjtGVFpp: children: - - CHART-5QwNlSbXYU - - CHART-37fu7fO6Z0 + - CHART-5QwNlSbXYU + - CHART-37fu7fO6Z0 id: ROW-kNjtGVFpp meta: background: BACKGROUND_TRANSPARENT parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-l_9I0aNYZ + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-l_9I0aNYZ type: ROW ROW-mOvr_xWm1: children: - - MARKDOWN-zc2mWxZeox - - CHART-Q3pbwsH3id - - CHART-o-JPAWMZK- - - CHART-YSzS5GOOLf + - MARKDOWN-zc2mWxZeox + - CHART-Q3pbwsH3id + - CHART-o-JPAWMZK- + - CHART-YSzS5GOOLf id: ROW-mOvr_xWm1 meta: background: BACKGROUND_TRANSPARENT parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-AsMaxdYL_t + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-AsMaxdYL_t type: ROW ROW-s3l4os7YY: children: - - CHART-LjfhrUkEef - - CHART-ZECnzPz8Bi + - CHART-LjfhrUkEef + - CHART-ZECnzPz8Bi id: ROW-s3l4os7YY meta: background: BACKGROUND_TRANSPARENT parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-l_9I0aNYZ + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-l_9I0aNYZ type: ROW ROW-y-GwJPgxLr: children: - - MARKDOWN-__u6CsUyfh - - CHART-aytwlT4GAq + - MARKDOWN-__u6CsUyfh + - CHART-aytwlT4GAq id: ROW-y-GwJPgxLr meta: background: BACKGROUND_TRANSPARENT parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b - - TAB-AsMaxdYL_t + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b + - TAB-AsMaxdYL_t type: ROW TAB-AsMaxdYL_t: children: - - ROW-y-GwJPgxLr - - ROW-mOvr_xWm1 - - ROW-UsW-_RPAb + - ROW-y-GwJPgxLr + - ROW-mOvr_xWm1 + - ROW-UsW-_RPAb id: TAB-AsMaxdYL_t meta: text: Overview parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b type: TAB TAB-YT6eNksV-: children: - - ROW-DR80aHJA2c - - ROW--BIzjz9F0 + - ROW-DR80aHJA2c + - ROW--BIzjz9F0 id: TAB-YT6eNksV- meta: - text: "\U0001F680 Aspiring Developers" + text: 🚀 Aspiring Developers parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b type: TAB TAB-l_9I0aNYZ: children: - - ROW-b7USYEngT - - ROW-kNjtGVFpp - - ROW-s3l4os7YY + - ROW-b7USYEngT + - ROW-kNjtGVFpp + - ROW-s3l4os7YY id: TAB-l_9I0aNYZ meta: - text: "\U0001F4BB Current Developers" + text: 💻 Current Developers parents: - - ROOT_ID - - GRID_ID - - TABS-L-d9eyOE-b + - ROOT_ID + - GRID_ID + - TABS-L-d9eyOE-b type: TAB TABS-L-d9eyOE-b: children: - - TAB-AsMaxdYL_t - - TAB-YT6eNksV- - - TAB-l_9I0aNYZ + - TAB-AsMaxdYL_t + - TAB-YT6eNksV- + - TAB-l_9I0aNYZ id: TABS-L-d9eyOE-b meta: {} parents: - - ROOT_ID - - GRID_ID + - ROOT_ID + - GRID_ID type: TABS -metadata: - timed_refresh_immune_slices: [] - expanded_slices: {} - refresh_frequency: 0 - default_filters: "{}" - color_scheme: supersetColors - label_colors: - "0": "#FCC700" - "1": "#A868B7" - "15": "#3CCCCB" - "30": "#A38F79" - "45": "#8FD3E4" - age: "#1FA8C9" - Yes,: "#1FA8C9" - Female: "#454E7C" - Prefer: "#5AC189" - No,: "#FF7F44" - Male: "#666666" - Prefer not to say: "#E04355" - Ph.D.: "#FCC700" - associate's degree: "#A868B7" - bachelor's degree: "#3CCCCB" - high school diploma or equivalent (GED): "#A38F79" - master's degree (non-professional): "#8FD3E4" - no high school (secondary school): "#A1A6BD" - professional degree (MBA, MD, JD, etc.): "#ACE1C4" - some college credit, no degree: "#FEC0A1" - some high school: "#B2B2B2" - trade, technical, or vocational training: "#EFA1AA" - No, not an ethnic minority: "#1FA8C9" - Yes, an ethnic minority: "#454E7C" - : "#5AC189" - "Yes": "#FF7F44" - "No": "#666666" - last_yr_income: "#E04355" - More: "#A1A6BD" - Less: "#ACE1C4" - I: "#FEC0A1" - expected_earn: "#B2B2B2" - "Yes: Willing To": "#EFA1AA" - "No: Not Willing to": "#FDE380" - No Answer: "#D3B3DA" - In an Office (with Other Developers): "#9EE5E5" - No Preference: "#D1C6BC" - From Home: "#1FA8C9" +published: true +slug: null +uuid: 5b12b583-8204-08e9-392c-422209c29787 version: 1.0.0 diff --git a/superset/examples/fcc_new_coder_survey/data.parquet b/superset/examples/fcc_new_coder_survey/data.parquet new file mode 100644 index 00000000000..8ca16732c2a Binary files /dev/null and b/superset/examples/fcc_new_coder_survey/data.parquet differ diff --git a/superset/examples/fcc_new_coder_survey/dataset.yaml b/superset/examples/fcc_new_coder_survey/dataset.yaml new file mode 100644 index 00000000000..91ede4a8346 --- /dev/null +++ b/superset/examples/fcc_new_coder_survey/dataset.yaml @@ -0,0 +1,1760 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +always_filter_main_dttm: false +cache_timeout: null +catalog: null +columns: +- advanced_data_type: null + column_name: willing_to_relocate + description: null + expression: "CASE \nWHEN job_relocate = 0 THEN 'No: Not Willing to' \nWHEN job_relocate\ + \ = 1 THEN 'Yes: Willing To'\nELSE 'No Answer'\nEND" + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: STRING + verbose_name: Willing To Relocate +- advanced_data_type: null + column_name: age + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: highest_degree_earned + description: Highest Degree Earned + expression: "CASE \n WHEN school_degree = 'no high school (secondary school)' THEN\ + \ 'A. No high school (secondary school)'\n WHEN school_degree = 'some high school'\ + \ THEN 'B. Some high school'\n WHEN school_degree = 'high school diploma or equivalent\ + \ (GED)' THEN 'C. High school diploma or equivalent (GED)'\n WHEN school_degree\ + \ = 'associate''s degree' THEN 'D. Associate''s degree'\n WHEN school_degree\ + \ = 'some college credit, no degree' THEN 'E. Some college credit, no degree'\n\ + \ WHEN school_degree = 'bachelor''s degree' THEN 'F. Bachelor''s degree'\n WHEN\ + \ school_degree = 'trade, technical, or vocational training' THEN 'G. Trade, technical,\ + \ or vocational training'\n WHEN school_degree = 'master''s degree (non-professional)'\ + \ THEN 'H. Master''s degree (non-professional)'\n WHEN school_degree = 'Ph.D.'\ + \ THEN 'I. Ph.D.'\n WHEN school_degree = 'professional degree (MBA, MD, JD, etc.)'\ + \ THEN 'J. Professional degree (MBA, MD, JD, etc.)'\nEND" + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: STRING + verbose_name: Highest Degree Earned +- advanced_data_type: null + column_name: job_location_preference + description: null + expression: "case \nwhen job_lctn_pref is Null then 'No Answer' \nwhen job_lctn_pref\ + \ = 'from home' then 'From Home'\nwhen job_lctn_pref = 'no preference' then 'No\ + \ Preference'\nwhen job_lctn_pref = 'in an office with other developers' then\ + \ 'In an Office (with Other Developers)'\nelse job_lctn_pref\nend " + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: null + verbose_name: Job Location Preference +- advanced_data_type: null + column_name: ethnic_minority + description: null + expression: "CASE \nWHEN is_ethnic_minority = 0 THEN 'No, not an ethnic minority'\ + \ \nWHEN is_ethnic_minority = 1 THEN 'Yes, an ethnic minority' \nELSE 'No Answer'\n\ + END" + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: null + python_date_format: null + type: STRING + verbose_name: Ethnic Minority +- advanced_data_type: null + column_name: developer_type + description: null + expression: CASE WHEN is_software_dev = 0 THEN 'Aspiring Developer' WHEN is_software_dev + = 1 THEN 'Currently A Developer' END + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: STRING + verbose_name: Developer Type +- advanced_data_type: null + column_name: first_time_developer + description: null + expression: "CASE \nWHEN is_first_dev_job = 0 THEN 'No' \nWHEN is_first_dev_job\ + \ = 1 THEN 'Yes' \nELSE 'No Answer'\nEND" + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: null + verbose_name: First Time Developer +- advanced_data_type: null + column_name: calc_first_time_dev + description: null + expression: CASE WHEN is_first_dev_job = 0 THEN 'No' WHEN is_first_dev_job = 1 THEN + 'Yes' END + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: STRING + verbose_name: null +- advanced_data_type: null + column_name: yt_codingtuts360 + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: is_recv_disab_bnft + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: job_intr_qa_engn + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: has_high_spd_ntnet + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: is_first_dev_job + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: job_intr_ux_engn + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: bootcamp_have_loan + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: podcast_js_jabber + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: job_intr_datasci + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: job_intr_dataengn + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: rsrc_khan_acdm + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: has_finance_depends + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: has_served_military + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: job_intr_backend + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: job_intr_teacher + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: months_job_search + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: student_debt_has + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: student_debt_amt + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: job_intr_gamedev + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: rsrc_code_wars + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: do_finance_support + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: last_yr_income + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: is_software_dev + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: money_for_learning + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: home_mrtg_has + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: job_intr_mobile + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: job_intr_infosec + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: job_intr_fllstck + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: job_intr_frntend + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: job_intr_devops + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: job_intr_projm + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: rsrc_css_tricks + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: yt_cs_dojo + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: is_ethnic_minority + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: yt_mit_ocw + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: is_self_employed + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: home_mrtg_owe + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: yt_engn_truth + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: bootcamp_attend + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: yt_derekbanas + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: yt_learncodeacdm + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: podcast_changelog + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: rsrc_hackerrank + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: podcast_devtea + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: podcast_sedaily + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: podcast_seradio + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: codeevnt_gamejam + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: podcast_geekspeak + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: podcast_talkpythonme + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: podcast_hanselmnts + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: podcast_syntaxfm + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: podcast_shoptalk + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: yt_mozillahacks + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: podcast_codingblcks + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: podcast_codenewbie + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: bootcamp_recommend + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: codeevnt_railsbrdg + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: bootcamp_finished + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: podcast_rubyrogues + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: job_relocate + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: debt_amt + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: rsrc_codeacdm + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: podcast_fcc + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: podcast_codepenrd + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: podcast_fullstckrd + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: codeevnt_hackthn + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: rsrc_udacity + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: podcast_ltcwm + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: rsrc_coursera + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: codeevnt_djangogrls + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: codeevnt_startupwknd + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: podcast_progthrwdwn + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: expected_earn + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: rsrc_egghead + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: codeevnt_railsgrls + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: has_children + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: podcast_frnthppyhr + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: yt_codingtrain + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: rsrc_lynda + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: hours_learning + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: yt_simplilearn + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: codeevnt_wkndbtcmp + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: codeevnt_fcc + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: rsrc_fcc + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: codeevnt_coderdojo + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: codeevnt_nodeschl + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: codeevnt_womenwc + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: codeevnt_confs + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: yt_fcc + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: codeevnt_girldevit + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: codeevnt_meetup + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: codeevnt_workshps + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: rsrc_frntendmstr + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: num_children + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: rsrc_udemy + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: rsrc_edx + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: rsrc_mdn + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: rsrc_treehouse + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: yt_computerphile + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: yt_funfunfunct + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: rsrc_so + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: yt_googledevs + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: yt_devtips + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: yt_simpleprog + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: yt_lvluptuts + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: time_start + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: true + python_date_format: null + type: DATETIME + verbose_name: null +- advanced_data_type: null + column_name: time_total_sec + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: months_programming + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: ID + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: reasons_to_code_other + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: lang_at_home + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: when_appl_job + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: reasons_to_code + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: live_city_population + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: job_lctn_pref + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: job_intr_other + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: marital_status + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: bootcamp_name + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: podcast_other + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: school_major + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: job_pref + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: country_citizen + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: school_degree + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: codeevnt_other + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: curr_field + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: communite_time + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: rsrc_other + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: country_live + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: gender_other + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: time_end + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: network_id + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: yt_other + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: gender + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +data_file: data.parquet +database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee +default_endpoint: null +description: null +extra: null +fetch_values_predicate: null +filter_select_enabled: true +folders: null +main_dttm_col: null +metrics: +- currency: null + d3format: null + description: null + expression: COUNT(*) + extra: null + metric_name: count + metric_type: null + verbose_name: COUNT(*) + warning_text: null +normalize_columns: false +offset: 0 +params: null +schema: null +sql: null +table_name: FCC 2018 Survey +template_params: null +uuid: d95a2865-53ce-1f82-a53d-8e3c89331469 +version: 1.0.0 diff --git a/superset/examples/configs/charts/Featured Charts/Area.yaml b/superset/examples/featured_charts/charts/Area.yaml similarity index 69% rename from superset/examples/configs/charts/Featured Charts/Area.yaml rename to superset/examples/featured_charts/charts/Area.yaml index 157aaff70a7..cfbaadce88d 100644 --- a/superset/examples/configs/charts/Featured Charts/Area.yaml +++ b/superset/examples/featured_charts/charts/Area.yaml @@ -14,84 +14,85 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Area -description: null -certified_by: null +cache_timeout: null certification_details: null -viz_type: echarts_area +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null params: + adhoc_filters: + - clause: WHERE + comparator: No filter + expressionType: SIMPLE + operator: TEMPORAL_RANGE + subject: order_date + annotation_layers: [] + color_scheme: supersetColors + comparison_type: values + dashboards: + - 13 datasource: 22__table + extra_form_data: {} + forecastInterval: 0.8 + forecastPeriods: 10 + groupby: + - deal_size + legendOrientation: top + legendType: scroll + markerSize: 6 + metrics: + - aggregate: SUM + column: + advanced_data_type: null + certification_details: null + certified_by: null + column_name: sales + description: null + expression: null + filterable: true + groupby: true + id: 734 + is_certified: false + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + type_generic: 0 + verbose_name: null + warning_markdown: null + datasourceWarning: false + expressionType: SIMPLE + hasCustomLabel: false + label: SUM(sales) + optionName: metric_thuvfstatme_5o1pircsnev + sqlExpression: null + only_total: true + opacity: 0.2 + order_desc: true + rich_tooltip: true + row_limit: 10000 + seriesType: echarts_timeseries_line + show_empty_columns: true + show_legend: true + sort_series_type: sum + time_grain_sqla: P1W + tooltipTimeFormat: smart_date + truncateXAxis: true + truncate_metric: true viz_type: echarts_area x_axis: order_date - time_grain_sqla: P1W x_axis_sort_asc: true x_axis_sort_series: name x_axis_sort_series_ascending: true - metrics: - - expressionType: SIMPLE - column: - advanced_data_type: null - certification_details: null - certified_by: null - column_name: sales - description: null - expression: null - filterable: true - groupby: true - id: 734 - is_certified: false - is_dttm: false - python_date_format: null - type: DOUBLE PRECISION - type_generic: 0 - verbose_name: null - warning_markdown: null - aggregate: SUM - sqlExpression: null - datasourceWarning: false - hasCustomLabel: false - label: SUM(sales) - optionName: metric_thuvfstatme_5o1pircsnev - groupby: - - deal_size - adhoc_filters: - - clause: WHERE - subject: order_date - operator: TEMPORAL_RANGE - comparator: No filter - expressionType: SIMPLE - order_desc: true - row_limit: 10000 - truncate_metric: true - show_empty_columns: true - comparison_type: values - annotation_layers: [] - forecastPeriods: 10 - forecastInterval: 0.8 + x_axis_time_format: smart_date x_axis_title_margin: 15 + y_axis_bounds: + - null + - null + y_axis_format: SMART_NUMBER y_axis_title_margin: 15 y_axis_title_position: Left - sort_series_type: sum - color_scheme: supersetColors - seriesType: echarts_timeseries_line - opacity: 0.2 - only_total: true - markerSize: 6 - show_legend: true - legendType: scroll - legendOrientation: top - x_axis_time_format: smart_date - rich_tooltip: true - tooltipTimeFormat: smart_date - y_axis_format: SMART_NUMBER - truncateXAxis: true - y_axis_bounds: - - null - - null - extra_form_data: {} - dashboards: - - 13 -cache_timeout: null +query_context: null +slice_name: Area uuid: 946cccb5-2101-44f5-98f8-501789a333cd version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +viz_type: echarts_area diff --git a/superset/examples/configs/charts/Featured Charts/Bar.yaml b/superset/examples/featured_charts/charts/Bar.yaml similarity index 90% rename from superset/examples/configs/charts/Featured Charts/Bar.yaml rename to superset/examples/featured_charts/charts/Bar.yaml index 13be80c4f98..c2d4f0f9635 100644 --- a/superset/examples/configs/charts/Featured Charts/Bar.yaml +++ b/superset/examples/featured_charts/charts/Bar.yaml @@ -14,59 +14,60 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Bar -description: null -certified_by: null +cache_timeout: null certification_details: null -viz_type: echarts_timeseries_bar +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null params: + adhoc_filters: + - clause: WHERE + comparator: No filter + expressionType: SIMPLE + operator: TEMPORAL_RANGE + subject: order_date + annotation_layers: [] + color_scheme: supersetColors + comparison_type: values + dashboards: + - 13 datasource: 22__table + extra_form_data: {} + forecastInterval: 0.8 + forecastPeriods: 10 + groupby: + - deal_size + legendOrientation: top + legendType: scroll + metrics: + - count + only_total: true + order_desc: true + orientation: vertical + rich_tooltip: true + row_limit: 10000 + show_empty_columns: true + show_legend: true + sort_series_type: sum + time_grain_sqla: P1M + tooltipTimeFormat: smart_date + truncateXAxis: true + truncate_metric: true viz_type: echarts_timeseries_bar x_axis: order_date - time_grain_sqla: P1M x_axis_sort_asc: true x_axis_sort_series: name x_axis_sort_series_ascending: true - metrics: - - count - groupby: - - deal_size - adhoc_filters: - - clause: WHERE - subject: order_date - operator: TEMPORAL_RANGE - comparator: No filter - expressionType: SIMPLE - order_desc: true - row_limit: 10000 - truncate_metric: true - show_empty_columns: true - comparison_type: values - annotation_layers: [] - forecastPeriods: 10 - forecastInterval: 0.8 - orientation: vertical + x_axis_time_format: smart_date x_axis_title_margin: 15 + y_axis_bounds: + - null + - null + y_axis_format: SMART_NUMBER y_axis_title_margin: 15 y_axis_title_position: Left - sort_series_type: sum - color_scheme: supersetColors - only_total: true - show_legend: true - legendType: scroll - legendOrientation: top - x_axis_time_format: smart_date - y_axis_format: SMART_NUMBER - truncateXAxis: true - y_axis_bounds: - - null - - null - rich_tooltip: true - tooltipTimeFormat: smart_date - extra_form_data: {} - dashboards: - - 13 -cache_timeout: null +query_context: null +slice_name: Bar uuid: 7a37f7d8-6deb-4fd3-a150-01b0ff532dbd version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +viz_type: echarts_timeseries_bar diff --git a/superset/examples/configs/charts/Featured Charts/Big_Number.yaml b/superset/examples/featured_charts/charts/Big_Number.yaml similarity index 87% rename from superset/examples/configs/charts/Featured Charts/Big_Number.yaml rename to superset/examples/featured_charts/charts/Big_Number.yaml index acce2b47be3..cb2ee724183 100644 --- a/superset/examples/configs/charts/Featured Charts/Big_Number.yaml +++ b/superset/examples/featured_charts/charts/Big_Number.yaml @@ -14,29 +14,31 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Big Number -description: null -certified_by: null -certification_details: null -viz_type: big_number_total -params: - datasource: 22__table - viz_type: big_number_total - metric: count - adhoc_filters: - - clause: WHERE - subject: order_date - operator: TEMPORAL_RANGE - comparator: No filter - expressionType: SIMPLE - header_font_size: 0.4 - subheader_font_size: 0.15 - y_axis_format: SMART_NUMBER - time_format: smart_date - extra_form_data: {} - dashboards: - - 13 cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null +params: + adhoc_filters: + - clause: WHERE + comparator: No filter + expressionType: SIMPLE + operator: TEMPORAL_RANGE + subject: order_date + annotation_layers: [] + dashboards: + - 13 + datasource: 22__table + extra_form_data: {} + header_font_size: 0.4 + metric: count + subheader_font_size: 0.15 + time_format: smart_date + viz_type: big_number_total + y_axis_format: SMART_NUMBER +query_context: null +slice_name: Big Number uuid: 5adc2abe-bfa3-4091-9838-4a470031208c version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +viz_type: big_number_total diff --git a/superset/examples/configs/charts/Featured Charts/Big_Number_with_Trendline.yaml b/superset/examples/featured_charts/charts/Big_Number_with_Trendline.yaml similarity index 89% rename from superset/examples/configs/charts/Featured Charts/Big_Number_with_Trendline.yaml rename to superset/examples/featured_charts/charts/Big_Number_with_Trendline.yaml index 748d59d8e6b..8e91da133fc 100644 --- a/superset/examples/configs/charts/Featured Charts/Big_Number_with_Trendline.yaml +++ b/superset/examples/featured_charts/charts/Big_Number_with_Trendline.yaml @@ -14,39 +14,41 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Big Number with Trendline -description: null -certified_by: null +cache_timeout: null certification_details: null -viz_type: big_number +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null params: - datasource: 22__table - viz_type: big_number - x_axis: order_date - time_grain_sqla: P1M - metric: count adhoc_filters: - - clause: WHERE - subject: order_date - operator: TEMPORAL_RANGE - comparator: No filter - expressionType: SIMPLE + - clause: WHERE + comparator: No filter + expressionType: SIMPLE + operator: TEMPORAL_RANGE + subject: order_date + annotation_layers: [] + color_picker: + a: 1 + b: 135 + g: 122 + r: 0 + dashboards: + - 13 + datasource: 22__table + extra_form_data: {} + header_font_size: 0.4 + metric: count + rolling_type: None show_trend_line: true start_y_axis_at_zero: true - color_picker: - r: 0 - g: 122 - b: 135 - a: 1 - header_font_size: 0.4 subheader_font_size: 0.15 - y_axis_format: SMART_NUMBER time_format: smart_date - rolling_type: None - extra_form_data: {} - dashboards: - - 13 -cache_timeout: null + time_grain_sqla: P1M + viz_type: big_number + x_axis: order_date + y_axis_format: SMART_NUMBER +query_context: null +slice_name: Big Number with Trendline uuid: 281656a3-3d8d-4423-8b58-b050d59fadd9 version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +viz_type: big_number diff --git a/superset/examples/configs/charts/Featured Charts/Box_Plot.yaml b/superset/examples/featured_charts/charts/Box_Plot.yaml similarity index 86% rename from superset/examples/configs/charts/Featured Charts/Box_Plot.yaml rename to superset/examples/featured_charts/charts/Box_Plot.yaml index 84950ed7382..4c2dca212d7 100644 --- a/superset/examples/configs/charts/Featured Charts/Box_Plot.yaml +++ b/superset/examples/featured_charts/charts/Box_Plot.yaml @@ -14,41 +14,43 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Box Plot -description: null -certified_by: null +cache_timeout: null certification_details: null -viz_type: box_plot +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null params: - datasource: 22__table - viz_type: box_plot - columns: - - order_date - time_grain_sqla: P1D - temporal_columns_lookup: - order_date: true - groupby: - - product_line - metrics: - - count adhoc_filters: - - clause: WHERE - subject: order_date - operator: TEMPORAL_RANGE - comparator: No filter - expressionType: SIMPLE - whiskerOptions: Tukey - x_axis_title_margin: 15 - y_axis_title_margin: 15 - y_axis_title_position: Left + - clause: WHERE + comparator: No filter + expressionType: SIMPLE + operator: TEMPORAL_RANGE + subject: order_date + annotation_layers: [] color_scheme: supersetColors - x_ticks_layout: auto - number_format: SMART_NUMBER + columns: + - order_date + dashboards: + - 13 + datasource: 22__table date_format: smart_date extra_form_data: {} - dashboards: - - 13 -cache_timeout: null + groupby: + - product_line + metrics: + - count + number_format: SMART_NUMBER + temporal_columns_lookup: + order_date: true + time_grain_sqla: P1D + viz_type: box_plot + whiskerOptions: Tukey + x_axis_title_margin: 15 + x_ticks_layout: auto + y_axis_title_margin: 15 + y_axis_title_position: Left +query_context: null +slice_name: Box Plot uuid: cc8eea37-f890-4816-8df0-b1354d7cd553 version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +viz_type: box_plot diff --git a/superset/examples/configs/charts/Featured Charts/Bubble.yaml b/superset/examples/featured_charts/charts/Bubble.yaml similarity index 92% rename from superset/examples/configs/charts/Featured Charts/Bubble.yaml rename to superset/examples/featured_charts/charts/Bubble.yaml index c52f25142c1..decd55c177d 100644 --- a/superset/examples/configs/charts/Featured Charts/Bubble.yaml +++ b/superset/examples/featured_charts/charts/Bubble.yaml @@ -14,18 +14,39 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Bubble -description: null -certified_by: null +cache_timeout: null certification_details: null -viz_type: bubble_v2 +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null params: - datasource: 22__table - viz_type: bubble_v2 - series: product_line - entity: deal_size - x: + adhoc_filters: + - clause: WHERE + comparator: No filter expressionType: SIMPLE + operator: TEMPORAL_RANGE + subject: order_date + annotation_layers: [] + color_scheme: supersetColors + dashboards: + - 13 + datasource: 22__table + entity: deal_size + extra_form_data: {} + legendOrientation: top + legendType: scroll + max_bubble_size: '25' + opacity: 0.6 + order_desc: true + row_limit: 10000 + series: product_line + show_legend: true + size: count + tooltipSizeFormat: SMART_NUMBER + truncateXAxis: true + viz_type: bubble_v2 + x: + aggregate: SUM column: advanced_data_type: null certification_details: null @@ -43,14 +64,16 @@ params: type_generic: 0 verbose_name: null warning_markdown: null - aggregate: SUM - sqlExpression: null datasourceWarning: false + expressionType: SIMPLE hasCustomLabel: false label: SUM(quantity_ordered) optionName: metric_ieq28dvzapm_wsnd3sj3trn + sqlExpression: null + xAxisFormat: SMART_NUMBER + x_axis_title_margin: 30 y: - expressionType: SIMPLE + aggregate: COUNT_DISTINCT column: advanced_data_type: null certification_details: null @@ -68,40 +91,19 @@ params: type_generic: 1 verbose_name: null warning_markdown: null - aggregate: COUNT_DISTINCT - sqlExpression: null datasourceWarning: false + expressionType: SIMPLE hasCustomLabel: false label: COUNT_DISTINCT(country) optionName: metric_2pvgxo9w3dc_fazapv2jd65 - adhoc_filters: - - clause: WHERE - subject: order_date - operator: TEMPORAL_RANGE - comparator: No filter - expressionType: SIMPLE - size: count - order_desc: true - row_limit: 10000 - color_scheme: supersetColors - show_legend: true - legendType: scroll - legendOrientation: top - max_bubble_size: "25" - tooltipSizeFormat: SMART_NUMBER - opacity: 0.6 - x_axis_title_margin: 30 - xAxisFormat: SMART_NUMBER - y_axis_title_margin: 30 - y_axis_format: SMART_NUMBER - truncateXAxis: true + sqlExpression: null y_axis_bounds: - - null - - null - extra_form_data: {} - dashboards: - - 13 -cache_timeout: null + - null + - null + y_axis_format: SMART_NUMBER + y_axis_title_margin: 30 +query_context: null +slice_name: Bubble uuid: c2014499-6800-43f0-908f-a2633db3ade7 version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +viz_type: bubble_v2 diff --git a/superset/examples/configs/charts/Featured Charts/Funnel.yaml b/superset/examples/featured_charts/charts/Funnel.yaml similarity index 88% rename from superset/examples/configs/charts/Featured Charts/Funnel.yaml rename to superset/examples/featured_charts/charts/Funnel.yaml index 219a66b5465..9144826dc88 100644 --- a/superset/examples/configs/charts/Featured Charts/Funnel.yaml +++ b/superset/examples/featured_charts/charts/Funnel.yaml @@ -14,38 +14,40 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Funnel -description: null -certified_by: null -certification_details: null -viz_type: funnel -params: - datasource: 22__table - viz_type: funnel - groupby: - - status - metric: count - adhoc_filters: - - clause: WHERE - subject: order_date - operator: TEMPORAL_RANGE - comparator: No filter - expressionType: SIMPLE - row_limit: 10 - sort_by_metric: true - percent_calculation_type: first_step - color_scheme: supersetColors - show_legend: true - legendOrientation: top - legendMargin: 50 - tooltip_label_type: 5 - number_format: SMART_NUMBER - show_labels: true - show_tooltip_labels: true - extra_form_data: {} - dashboards: - - 13 cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null +params: + adhoc_filters: + - clause: WHERE + comparator: No filter + expressionType: SIMPLE + operator: TEMPORAL_RANGE + subject: order_date + annotation_layers: [] + color_scheme: supersetColors + dashboards: + - 13 + datasource: 22__table + extra_form_data: {} + groupby: + - status + legendMargin: 50 + legendOrientation: top + metric: count + number_format: SMART_NUMBER + percent_calculation_type: first_step + row_limit: 10 + show_labels: true + show_legend: true + show_tooltip_labels: true + sort_by_metric: true + tooltip_label_type: 5 + viz_type: funnel +query_context: null +slice_name: Funnel uuid: 7b90545c-1aac-447d-9175-a49f508f699d version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +viz_type: funnel diff --git a/superset/examples/configs/charts/Featured Charts/Gantt.yaml b/superset/examples/featured_charts/charts/Gantt.yaml similarity index 98% rename from superset/examples/configs/charts/Featured Charts/Gantt.yaml rename to superset/examples/featured_charts/charts/Gantt.yaml index 6a564d07a08..354e2fb0e29 100644 --- a/superset/examples/configs/charts/Featured Charts/Gantt.yaml +++ b/superset/examples/featured_charts/charts/Gantt.yaml @@ -14,52 +14,53 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Gantt -description: null -certified_by: null +cache_timeout: null certification_details: null -viz_type: gantt_chart +certified_by: null +dataset_uuid: d638a239-f255-44fc-b0c1-c3f3b7f00ee0 +description: null params: - datasource: 61__table - viz_type: gantt_chart - slice_id: 1495 - start_time: start_time - end_time: end_time - y_axis: status - series: priority - subcategories: true - tooltip_columns: - - project - - phase adhoc_filters: - clause: WHERE comparator: No filter expressionType: SIMPLE operator: TEMPORAL_RANGE subject: start_time + annotation_layers: [] + color_scheme: supersetAndPresetColors + dashboards: + - 9 + datasource: 61__table + end_time: end_time + extra_form_data: {} + legendMargin: 100 + legendOrientation: right + legendType: plain order_by_cols: - '["status",false]' row_limit: 10000 - x_axis_title_margin: 15 - y_axis_title_margin: 50 - color_scheme: supersetAndPresetColors - show_legend: true - legendType: plain - legendOrientation: right - legendMargin: 100 - zoomable: false + series: priority show_extra_controls: false - x_axis_time_bounds: - - '08:00:00' - - '19:00:00' - x_axis_time_format: smart_date + show_legend: true + slice_id: 1495 + start_time: start_time + subcategories: true tooltipTimeFormat: smart_date tooltipValuesFormat: SMART_NUMBER - extra_form_data: {} - dashboards: - - 9 + tooltip_columns: + - project + - phase + viz_type: gantt_chart + x_axis_time_bounds: + - 08:00:00 + - '19:00:00' + x_axis_time_format: smart_date + x_axis_title_margin: 15 + y_axis: status + y_axis_title_margin: 50 + zoomable: false query_context: null -cache_timeout: null +slice_name: Gantt uuid: c91c242e-ec16-43e4-84fd-1c69336e0a99 version: 1.0.0 -dataset_uuid: d638a239-f255-44fc-b0c1-c3f3b7f00ee0 +viz_type: gantt_chart diff --git a/superset/examples/configs/charts/Featured Charts/Gauge.yaml b/superset/examples/featured_charts/charts/Gauge.yaml similarity index 87% rename from superset/examples/configs/charts/Featured Charts/Gauge.yaml rename to superset/examples/featured_charts/charts/Gauge.yaml index 45c0e1d731b..18479f2b8bc 100644 --- a/superset/examples/configs/charts/Featured Charts/Gauge.yaml +++ b/superset/examples/featured_charts/charts/Gauge.yaml @@ -14,41 +14,43 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Gauge -description: null -certified_by: null +cache_timeout: null certification_details: null -viz_type: gauge_chart +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null params: - datasource: 22__table - viz_type: gauge_chart - groupby: - - deal_size - metric: count adhoc_filters: - - clause: WHERE - subject: order_date - operator: TEMPORAL_RANGE - comparator: No filter - expressionType: SIMPLE - row_limit: 10 - start_angle: 225 - end_angle: -45 - color_scheme: supersetColors - font_size: 13 - number_format: SMART_NUMBER - value_formatter: "{value}" - show_pointer: true + - clause: WHERE + comparator: No filter + expressionType: SIMPLE + operator: TEMPORAL_RANGE + subject: order_date animation: true - show_axis_tick: false - show_split_line: false - split_number: 10 - show_progress: true + annotation_layers: [] + color_scheme: supersetColors + dashboards: [] + datasource: 22__table + end_angle: -45 + extra_form_data: {} + font_size: 13 + groupby: + - deal_size + metric: count + number_format: SMART_NUMBER overlap: true round_cap: false - extra_form_data: {} - dashboards: [] -cache_timeout: null + row_limit: 10 + show_axis_tick: false + show_pointer: true + show_progress: true + show_split_line: false + split_number: 10 + start_angle: 225 + value_formatter: '{value}' + viz_type: gauge_chart +query_context: null +slice_name: Gauge uuid: 57ccf0f1-d28a-4127-9581-7153c5a15b62 version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +viz_type: gauge_chart diff --git a/superset/examples/configs/charts/Featured Charts/Graph.yaml b/superset/examples/featured_charts/charts/Graph.yaml similarity index 89% rename from superset/examples/configs/charts/Featured Charts/Graph.yaml rename to superset/examples/featured_charts/charts/Graph.yaml index 72406fbe6ef..2fc9e2afa1c 100644 --- a/superset/examples/configs/charts/Featured Charts/Graph.yaml +++ b/superset/examples/featured_charts/charts/Graph.yaml @@ -14,41 +14,43 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Graph -description: null -certified_by: null +cache_timeout: null certification_details: null -viz_type: graph_chart +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null params: + adhoc_filters: + - clause: WHERE + comparator: No filter + expressionType: SIMPLE + operator: TEMPORAL_RANGE + subject: order_date + annotation_layers: [] + baseEdgeWidth: 3 + baseNodeSize: 20 + color_scheme: supersetColors + dashboards: [] datasource: 22__table - viz_type: graph_chart + edgeLength: 400 + edgeSymbol: none,arrow + extra_form_data: {} + friction: 0.2 + gravity: 0.3 + layout: circular + legendOrientation: top + legendType: scroll + metric: count + repulsion: 1000 + roam: true + row_limit: 10000 + selectedMode: single + show_legend: true source: deal_size target: product_line - metric: count - adhoc_filters: - - clause: WHERE - subject: order_date - operator: TEMPORAL_RANGE - comparator: No filter - expressionType: SIMPLE - row_limit: 10000 - color_scheme: supersetColors - show_legend: true - legendType: scroll - legendOrientation: top - layout: circular - edgeSymbol: none,arrow - roam: true - selectedMode: single - baseNodeSize: 20 - baseEdgeWidth: 3 - edgeLength: 400 - gravity: 0.3 - repulsion: 1000 - friction: 0.2 - extra_form_data: {} - dashboards: [] -cache_timeout: null + viz_type: graph_chart +query_context: null +slice_name: Graph uuid: be39bc2e-00c0-498b-96bf-858fe2361a89 version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +viz_type: graph_chart diff --git a/superset/examples/configs/charts/Featured Charts/Heatmap.yaml b/superset/examples/featured_charts/charts/Heatmap.yaml similarity index 89% rename from superset/examples/configs/charts/Featured Charts/Heatmap.yaml rename to superset/examples/featured_charts/charts/Heatmap.yaml index 9a8c1473f79..9bdf6425878 100644 --- a/superset/examples/configs/charts/Featured Charts/Heatmap.yaml +++ b/superset/examples/featured_charts/charts/Heatmap.yaml @@ -14,46 +14,48 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Heatmap -description: null -certified_by: null +cache_timeout: null certification_details: null -viz_type: heatmap_v2 +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null params: - datasource: 22__table - viz_type: heatmap_v2 - x_axis: product_line - time_grain_sqla: P1D - groupby: deal_size - metric: count adhoc_filters: - - clause: WHERE - subject: order_date - operator: TEMPORAL_RANGE - comparator: No filter - expressionType: SIMPLE - row_limit: 10000 - sort_x_axis: alpha_asc - sort_y_axis: alpha_asc - normalize_across: heatmap + - clause: WHERE + comparator: No filter + expressionType: SIMPLE + operator: TEMPORAL_RANGE + subject: order_date + annotation_layers: [] + bottom_margin: auto + dashboards: + - 13 + datasource: 22__table + extra_form_data: {} + groupby: deal_size + left_margin: auto legend_type: continuous linear_color_scheme: superset_seq_1 - xscale_interval: -1 - yscale_interval: -1 - left_margin: auto - bottom_margin: auto - value_bounds: - - null - - null - y_axis_format: SMART_NUMBER - x_axis_time_format: smart_date + metric: count + normalize_across: heatmap + row_limit: 10000 show_legend: true show_percentage: true show_values: true - extra_form_data: {} - dashboards: - - 13 -cache_timeout: null + sort_x_axis: alpha_asc + sort_y_axis: alpha_asc + time_grain_sqla: P1D + value_bounds: + - null + - null + viz_type: heatmap_v2 + x_axis: product_line + x_axis_time_format: smart_date + xscale_interval: -1 + y_axis_format: SMART_NUMBER + yscale_interval: -1 +query_context: null +slice_name: Heatmap uuid: c99dbe37-50da-4067-837c-3a8e5b68aafd version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +viz_type: heatmap_v2 diff --git a/superset/examples/configs/charts/Featured Charts/Histogram.yaml b/superset/examples/featured_charts/charts/Histogram.yaml similarity index 87% rename from superset/examples/configs/charts/Featured Charts/Histogram.yaml rename to superset/examples/featured_charts/charts/Histogram.yaml index 1789306bdb7..2150acc7c9f 100644 --- a/superset/examples/configs/charts/Featured Charts/Histogram.yaml +++ b/superset/examples/featured_charts/charts/Histogram.yaml @@ -14,33 +14,35 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Histogram -description: null -certified_by: null -certification_details: null -viz_type: histogram_v2 -params: - datasource: 22__table - viz_type: histogram_v2 - slice_id: 130 - column: quantity_ordered - groupby: - - deal_size - adhoc_filters: - - clause: WHERE - comparator: No filter - expressionType: SIMPLE - operator: TEMPORAL_RANGE - subject: order_date - row_limit: 10000 - bins: 10 - normalize: false - color_scheme: supersetAndPresetColors - show_value: false - show_legend: true - extra_form_data: {} - dashboards: [] cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null +params: + adhoc_filters: + - clause: WHERE + comparator: No filter + expressionType: SIMPLE + operator: TEMPORAL_RANGE + subject: order_date + annotation_layers: [] + bins: 10 + color_scheme: supersetAndPresetColors + column: quantity_ordered + dashboards: [] + datasource: 22__table + extra_form_data: {} + groupby: + - deal_size + normalize: false + row_limit: 10000 + show_legend: true + show_value: false + slice_id: 130 + viz_type: histogram_v2 +query_context: null +slice_name: Histogram uuid: 2a89c19d-d0d2-4f5e-9007-e0fb65440e80 version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +viz_type: histogram_v2 diff --git a/superset/examples/configs/charts/Featured Charts/Line.yaml b/superset/examples/featured_charts/charts/Line.yaml similarity index 90% rename from superset/examples/configs/charts/Featured Charts/Line.yaml rename to superset/examples/featured_charts/charts/Line.yaml index 4f241cf81fa..899e1915242 100644 --- a/superset/examples/configs/charts/Featured Charts/Line.yaml +++ b/superset/examples/featured_charts/charts/Line.yaml @@ -14,61 +14,62 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Line -description: null -certified_by: null +cache_timeout: null certification_details: null -viz_type: echarts_timeseries_line +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null params: + adhoc_filters: + - clause: WHERE + comparator: No filter + expressionType: SIMPLE + operator: TEMPORAL_RANGE + subject: order_date + annotation_layers: [] + color_scheme: supersetColors + comparison_type: values + dashboards: + - 13 datasource: 22__table + extra_form_data: {} + forecastInterval: 0.8 + forecastPeriods: 10 + groupby: + - product_line + legendOrientation: top + legendType: scroll + markerSize: 6 + metrics: + - count + only_total: true + opacity: 0.2 + order_desc: true + rich_tooltip: true + row_limit: 10000 + seriesType: echarts_timeseries_line + show_empty_columns: true + show_legend: true + sort_series_type: sum + time_grain_sqla: P1M + tooltipTimeFormat: smart_date + truncateXAxis: true + truncate_metric: true viz_type: echarts_timeseries_line x_axis: order_date - time_grain_sqla: P1M x_axis_sort_asc: true x_axis_sort_series: name x_axis_sort_series_ascending: true - metrics: - - count - groupby: - - product_line - adhoc_filters: - - clause: WHERE - subject: order_date - operator: TEMPORAL_RANGE - comparator: No filter - expressionType: SIMPLE - order_desc: true - row_limit: 10000 - truncate_metric: true - show_empty_columns: true - comparison_type: values - annotation_layers: [] - forecastPeriods: 10 - forecastInterval: 0.8 + x_axis_time_format: smart_date x_axis_title_margin: 15 + y_axis_bounds: + - null + - null + y_axis_format: SMART_NUMBER y_axis_title_margin: 15 y_axis_title_position: Left - sort_series_type: sum - color_scheme: supersetColors - seriesType: echarts_timeseries_line - only_total: true - opacity: 0.2 - markerSize: 6 - show_legend: true - legendType: scroll - legendOrientation: top - x_axis_time_format: smart_date - rich_tooltip: true - tooltipTimeFormat: smart_date - y_axis_format: SMART_NUMBER - truncateXAxis: true - y_axis_bounds: - - null - - null - extra_form_data: {} - dashboards: - - 13 -cache_timeout: null +query_context: null +slice_name: Line uuid: 79567e46-97f6-4cd2-8e98-4cd211389743 version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +viz_type: echarts_timeseries_line diff --git a/superset/examples/configs/charts/Featured Charts/Mixed.yaml b/superset/examples/featured_charts/charts/Mixed.yaml similarity index 67% rename from superset/examples/configs/charts/Featured Charts/Mixed.yaml rename to superset/examples/featured_charts/charts/Mixed.yaml index fc63e11a93a..15ad850b757 100644 --- a/superset/examples/configs/charts/Featured Charts/Mixed.yaml +++ b/superset/examples/featured_charts/charts/Mixed.yaml @@ -14,96 +14,97 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Mixed -description: null -certified_by: null +cache_timeout: null certification_details: null -viz_type: mixed_timeseries +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null params: - datasource: 22__table - viz_type: mixed_timeseries - x_axis: order_date - time_grain_sqla: P1M - metrics: - - expressionType: SIMPLE - column: - advanced_data_type: null - certification_details: null - certified_by: null - column_name: sales - description: null - expression: null - filterable: true - groupby: true - id: 734 - is_certified: false - is_dttm: false - python_date_format: null - type: DOUBLE PRECISION - type_generic: 0 - verbose_name: null - warning_markdown: null - aggregate: SUM - sqlExpression: null - datasourceWarning: false - hasCustomLabel: false - label: SUM(sales) - optionName: metric_b9hph4jr9i_nayy40sodwl - groupby: [] adhoc_filters: - - clause: WHERE - subject: order_date - operator: TEMPORAL_RANGE - comparator: No filter - expressionType: SIMPLE - order_desc: true - row_limit: 10000 - truncate_metric: true - comparison_type: values - metrics_b: - - count - groupby_b: [] + - clause: WHERE + comparator: No filter + expressionType: SIMPLE + operator: TEMPORAL_RANGE + subject: order_date adhoc_filters_b: - - clause: WHERE - subject: order_date - operator: TEMPORAL_RANGE - comparator: No filter - expressionType: SIMPLE - order_desc_b: true - row_limit_b: 10000 - truncate_metric_b: true - comparison_type_b: values + - clause: WHERE + comparator: No filter + expressionType: SIMPLE + operator: TEMPORAL_RANGE + subject: order_date annotation_layers: [] - x_axis_title_margin: 15 - y_axis_title_margin: 15 - y_axis_title_position: Left color_scheme: supersetColors - seriesType: echarts_timeseries_line - opacity: 0.2 - markerSize: 6 - yAxisIndex: 1 - seriesTypeB: echarts_timeseries_bar - opacityB: 0.2 - markerSizeB: 6 - yAxisIndexB: 0 - show_legend: true - legendType: scroll + comparison_type: values + comparison_type_b: values + dashboards: [] + datasource: 22__table + extra_form_data: {} + groupby: [] + groupby_b: [] legendOrientation: top - x_axis_time_format: smart_date + legendType: scroll + markerSize: 6 + markerSizeB: 6 + metrics: + - aggregate: SUM + column: + advanced_data_type: null + certification_details: null + certified_by: null + column_name: sales + description: null + expression: null + filterable: true + groupby: true + id: 734 + is_certified: false + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + type_generic: 0 + verbose_name: null + warning_markdown: null + datasourceWarning: false + expressionType: SIMPLE + hasCustomLabel: false + label: SUM(sales) + optionName: metric_b9hph4jr9i_nayy40sodwl + sqlExpression: null + metrics_b: + - count + opacity: 0.2 + opacityB: 0.2 + order_desc: true + order_desc_b: true rich_tooltip: true + row_limit: 10000 + row_limit_b: 10000 + seriesType: echarts_timeseries_line + seriesTypeB: echarts_timeseries_bar + show_legend: true + time_grain_sqla: P1M tooltipTimeFormat: smart_date truncateXAxis: true + truncate_metric: true + truncate_metric_b: true + viz_type: mixed_timeseries + x_axis: order_date + x_axis_time_format: smart_date + x_axis_title_margin: 15 + yAxisIndex: 1 + yAxisIndexB: 0 y_axis_bounds: - - null - - null - y_axis_format: SMART_NUMBER + - null + - null y_axis_bounds_secondary: - - null - - null + - null + - null + y_axis_format: SMART_NUMBER y_axis_format_secondary: SMART_NUMBER - extra_form_data: {} - dashboards: [] -cache_timeout: null + y_axis_title_margin: 15 + y_axis_title_position: Left +query_context: null +slice_name: Mixed uuid: bb394e7b-0cfc-47ba-b067-541964545752 version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +viz_type: mixed_timeseries diff --git a/superset/examples/configs/charts/Featured Charts/Pie.yaml b/superset/examples/featured_charts/charts/Pie.yaml similarity index 91% rename from superset/examples/configs/charts/Featured Charts/Pie.yaml rename to superset/examples/featured_charts/charts/Pie.yaml index 37abd9d9299..62e53cad070 100644 --- a/superset/examples/configs/charts/Featured Charts/Pie.yaml +++ b/superset/examples/featured_charts/charts/Pie.yaml @@ -14,18 +14,34 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Pie -description: null -certified_by: null +cache_timeout: null certification_details: null -viz_type: pie +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null params: - datasource: 22__table - viz_type: pie - groupby: - - product_line - metric: + adhoc_filters: + - clause: WHERE + comparator: No filter expressionType: SIMPLE + operator: TEMPORAL_RANGE + subject: order_date + annotation_layers: [] + color_scheme: supersetColors + dashboards: + - 13 + datasource: 22__table + date_format: smart_date + extra_form_data: {} + groupby: + - product_line + innerRadius: 30 + label_type: key + labels_outside: true + legendOrientation: top + legendType: scroll + metric: + aggregate: SUM column: advanced_data_type: null certification_details: null @@ -43,36 +59,22 @@ params: type_generic: 0 verbose_name: null warning_markdown: null - aggregate: SUM - sqlExpression: null datasourceWarning: false + expressionType: SIMPLE hasCustomLabel: false label: SUM(sales) optionName: metric_m2fycvcvjie_4gnezrycwmb - adhoc_filters: - - clause: WHERE - subject: order_date - operator: TEMPORAL_RANGE - comparator: No filter - expressionType: SIMPLE + sqlExpression: null + number_format: SMART_NUMBER + outerRadius: 70 row_limit: 100 - sort_by_metric: true - color_scheme: supersetColors + show_labels: true show_labels_threshold: 5 show_legend: true - legendType: scroll - legendOrientation: top - label_type: key - number_format: SMART_NUMBER - date_format: smart_date - show_labels: true - labels_outside: true - outerRadius: 70 - innerRadius: 30 - extra_form_data: {} - dashboards: - - 13 -cache_timeout: null + sort_by_metric: true + viz_type: pie +query_context: null +slice_name: Pie uuid: 02ed54c5-dc22-468c-9edf-729b5401b182 version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +viz_type: pie diff --git a/superset/examples/configs/charts/Featured Charts/Pivot_Table.yaml b/superset/examples/featured_charts/charts/Pivot_Table.yaml similarity index 63% rename from superset/examples/configs/charts/Featured Charts/Pivot_Table.yaml rename to superset/examples/featured_charts/charts/Pivot_Table.yaml index ecfc5a8d2c3..428aee7ad26 100644 --- a/superset/examples/configs/charts/Featured Charts/Pivot_Table.yaml +++ b/superset/examples/featured_charts/charts/Pivot_Table.yaml @@ -14,65 +14,67 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Pivot Table -description: null -certified_by: null +cache_timeout: null certification_details: null -viz_type: pivot_table_v2 +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null params: + adhoc_filters: + - clause: WHERE + comparator: No filter + expressionType: SIMPLE + operator: TEMPORAL_RANGE + subject: order_date + aggregateFunction: Sum + annotation_layers: [] + colOrder: key_a_to_z + dashboards: + - 13 datasource: 22__table - viz_type: pivot_table_v2 + date_format: smart_date + extra_form_data: {} groupbyColumns: - - product_line + - product_line groupbyRows: - - country - - city - time_grain_sqla: P1D + - country + - city + metrics: + - aggregate: SUM + column: + advanced_data_type: null + certification_details: null + certified_by: null + column_name: sales + description: null + expression: null + filterable: true + groupby: true + id: 734 + is_certified: false + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + type_generic: 0 + verbose_name: null + warning_markdown: null + datasourceWarning: false + expressionType: SIMPLE + hasCustomLabel: false + label: SUM(sales) + optionName: metric_psnoaxdky5h_ojfgcygk97c + sqlExpression: null + metricsLayout: COLUMNS + order_desc: true + rowOrder: key_a_to_z + row_limit: 10000 temporal_columns_lookup: order_date: true - metrics: - - expressionType: SIMPLE - column: - advanced_data_type: null - certification_details: null - certified_by: null - column_name: sales - description: null - expression: null - filterable: true - groupby: true - id: 734 - is_certified: false - is_dttm: false - python_date_format: null - type: DOUBLE PRECISION - type_generic: 0 - verbose_name: null - warning_markdown: null - aggregate: SUM - sqlExpression: null - datasourceWarning: false - hasCustomLabel: false - label: SUM(sales) - optionName: metric_psnoaxdky5h_ojfgcygk97c - metricsLayout: COLUMNS - adhoc_filters: - - clause: WHERE - subject: order_date - operator: TEMPORAL_RANGE - comparator: No filter - expressionType: SIMPLE - row_limit: 10000 - order_desc: true - aggregateFunction: Sum + time_grain_sqla: P1D valueFormat: SMART_NUMBER - date_format: smart_date - rowOrder: key_a_to_z - colOrder: key_a_to_z - extra_form_data: {} - dashboards: - - 13 -cache_timeout: null + viz_type: pivot_table_v2 +query_context: null +slice_name: Pivot Table uuid: fcf2a0cf-0079-4f59-854f-d28297b07bf0 version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +viz_type: pivot_table_v2 diff --git a/superset/examples/featured_charts/charts/Radar.yaml b/superset/examples/featured_charts/charts/Radar.yaml new file mode 100644 index 00000000000..ccf424daed9 --- /dev/null +++ b/superset/examples/featured_charts/charts/Radar.yaml @@ -0,0 +1,102 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null +params: + adhoc_filters: + - clause: WHERE + comparator: No filter + expressionType: SIMPLE + operator: TEMPORAL_RANGE + subject: order_date + annotation_layers: [] + color_scheme: supersetColors + dashboards: [] + datasource: 22__table + date_format: smart_date + extra_form_data: {} + groupby: + - product_line + is_circle: true + label_position: top + label_type: value + legendMargin: '' + legendOrientation: top + legendType: scroll + metrics: + - count + - aggregate: AVG + column: + advanced_data_type: null + certification_details: null + certified_by: null + column_name: price_each + description: null + expression: null + filterable: true + groupby: true + id: 733 + is_certified: false + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + type_generic: 0 + verbose_name: null + warning_markdown: null + datasourceWarning: false + expressionType: SIMPLE + hasCustomLabel: false + label: AVG(price_each) + optionName: metric_ethqy44wrel_gsqbm609hxt + sqlExpression: null + - aggregate: AVG + column: + advanced_data_type: null + certification_details: null + certified_by: null + column_name: sales + description: null + expression: null + filterable: true + groupby: true + id: 734 + is_certified: false + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + type_generic: 0 + verbose_name: null + warning_markdown: null + datasourceWarning: false + expressionType: SIMPLE + hasCustomLabel: false + label: AVG(sales) + optionName: metric_r5emvf2ybfe_blvnta3absu + sqlExpression: null + number_format: SMART_NUMBER + row_limit: 10 + show_labels: false + show_legend: true + viz_type: radar +query_context: null +slice_name: Radar +uuid: 1be00870-89b8-4ba0-a451-1fe56ef89581 +version: 1.0.0 +viz_type: radar diff --git a/superset/examples/configs/charts/Featured Charts/Sankey.yaml b/superset/examples/featured_charts/charts/Sankey.yaml similarity index 88% rename from superset/examples/configs/charts/Featured Charts/Sankey.yaml rename to superset/examples/featured_charts/charts/Sankey.yaml index 8540f5f6499..a107c340ec7 100644 --- a/superset/examples/configs/charts/Featured Charts/Sankey.yaml +++ b/superset/examples/featured_charts/charts/Sankey.yaml @@ -14,28 +14,30 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Sankey -description: null -certified_by: null +cache_timeout: null certification_details: null -viz_type: sankey_v2 +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null params: + adhoc_filters: + - clause: WHERE + comparator: No filter + expressionType: SIMPLE + operator: TEMPORAL_RANGE + subject: order_date + annotation_layers: [] + color_scheme: supersetColors + dashboards: [] datasource: 22__table - viz_type: sankey_v2 + extra_form_data: {} + metric: count + row_limit: 10000 source: product_line target: deal_size - metric: count - adhoc_filters: - - clause: WHERE - subject: order_date - operator: TEMPORAL_RANGE - comparator: No filter - expressionType: SIMPLE - row_limit: 10000 - color_scheme: supersetColors - extra_form_data: {} - dashboards: [] -cache_timeout: null + viz_type: sankey_v2 +query_context: null +slice_name: Sankey uuid: fead4d46-ecb9-4fd9-8b9c-420629269c02 version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +viz_type: sankey_v2 diff --git a/superset/examples/configs/charts/Featured Charts/Scatter_Plot.yaml b/superset/examples/featured_charts/charts/Scatter_Plot.yaml similarity index 90% rename from superset/examples/configs/charts/Featured Charts/Scatter_Plot.yaml rename to superset/examples/featured_charts/charts/Scatter_Plot.yaml index f2c76fe746a..a03f3421af9 100644 --- a/superset/examples/configs/charts/Featured Charts/Scatter_Plot.yaml +++ b/superset/examples/featured_charts/charts/Scatter_Plot.yaml @@ -14,59 +14,60 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Scatter Plot -description: null -certified_by: null +cache_timeout: null certification_details: null -viz_type: echarts_timeseries_scatter +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null params: + adhoc_filters: + - clause: WHERE + comparator: No filter + expressionType: SIMPLE + operator: TEMPORAL_RANGE + subject: order_date + annotation_layers: [] + color_scheme: supersetColors + comparison_type: values + dashboards: + - 13 datasource: 22__table + extra_form_data: {} + forecastInterval: 0.8 + forecastPeriods: 10 + groupby: + - deal_size + legendOrientation: top + legendType: scroll + markerSize: 6 + metrics: + - count + only_total: true + order_desc: true + rich_tooltip: true + row_limit: 10000 + show_empty_columns: true + show_legend: true + sort_series_type: sum + time_grain_sqla: P1D + tooltipTimeFormat: smart_date + truncateXAxis: true + truncate_metric: true viz_type: echarts_timeseries_scatter x_axis: order_date - time_grain_sqla: P1D x_axis_sort_asc: true x_axis_sort_series: name x_axis_sort_series_ascending: true - metrics: - - count - groupby: - - deal_size - adhoc_filters: - - clause: WHERE - subject: order_date - operator: TEMPORAL_RANGE - comparator: No filter - expressionType: SIMPLE - order_desc: true - row_limit: 10000 - truncate_metric: true - show_empty_columns: true - comparison_type: values - annotation_layers: [] - forecastPeriods: 10 - forecastInterval: 0.8 + x_axis_time_format: smart_date x_axis_title_margin: 15 + y_axis_bounds: + - null + - null + y_axis_format: SMART_NUMBER y_axis_title_margin: 15 y_axis_title_position: Left - sort_series_type: sum - color_scheme: supersetColors - only_total: true - markerSize: 6 - show_legend: true - legendType: scroll - legendOrientation: top - x_axis_time_format: smart_date - rich_tooltip: true - tooltipTimeFormat: smart_date - y_axis_format: SMART_NUMBER - truncateXAxis: true - y_axis_bounds: - - null - - null - extra_form_data: {} - dashboards: - - 13 -cache_timeout: null +query_context: null +slice_name: Scatter Plot uuid: 5b629855-f912-4e28-8444-56b9db83e5b3 version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +viz_type: echarts_timeseries_scatter diff --git a/superset/examples/configs/charts/Featured Charts/Sunburst.yaml b/superset/examples/featured_charts/charts/Sunburst.yaml similarity index 87% rename from superset/examples/configs/charts/Featured Charts/Sunburst.yaml rename to superset/examples/featured_charts/charts/Sunburst.yaml index 7e39133cb7c..53da2d1cbf8 100644 --- a/superset/examples/configs/charts/Featured Charts/Sunburst.yaml +++ b/superset/examples/featured_charts/charts/Sunburst.yaml @@ -14,35 +14,37 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Sunburst -description: null -certified_by: null +cache_timeout: null certification_details: null -viz_type: sunburst_v2 +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null params: - datasource: 22__table - viz_type: sunburst_v2 - columns: - - year - - product_line - metric: count adhoc_filters: - - clause: WHERE - subject: order_date - operator: TEMPORAL_RANGE - comparator: No filter - expressionType: SIMPLE - row_limit: 10000 + - clause: WHERE + comparator: No filter + expressionType: SIMPLE + operator: TEMPORAL_RANGE + subject: order_date + annotation_layers: [] color_scheme: supersetColors - linear_color_scheme: superset_seq_1 - show_labels: true - show_labels_threshold: 5 - label_type: key - number_format: ~g + columns: + - year + - product_line + dashboards: [] + datasource: 22__table date_format: smart_date extra_form_data: {} - dashboards: [] -cache_timeout: null + label_type: key + linear_color_scheme: superset_seq_1 + metric: count + number_format: ~g + row_limit: 10000 + show_labels: true + show_labels_threshold: 5 + viz_type: sunburst_v2 +query_context: null +slice_name: Sunburst uuid: 47b26af7-19e0-4ca1-9cf6-b74b2f1f7e3c version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +viz_type: sunburst_v2 diff --git a/superset/examples/configs/charts/Featured Charts/Table.yaml b/superset/examples/featured_charts/charts/Table.yaml similarity index 85% rename from superset/examples/configs/charts/Featured Charts/Table.yaml rename to superset/examples/featured_charts/charts/Table.yaml index 37a22af8c51..1821cd9d56d 100644 --- a/superset/examples/configs/charts/Featured Charts/Table.yaml +++ b/superset/examples/featured_charts/charts/Table.yaml @@ -14,44 +14,46 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Table -description: null -certified_by: null +cache_timeout: null certification_details: null -viz_type: table +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null params: - datasource: 22__table - viz_type: table - query_mode: raw - groupby: [] - time_grain_sqla: P1D - temporal_columns_lookup: - order_date: true - all_columns: - - order_date - - product_line - - status - - price_each - - sales - percent_metrics: [] adhoc_filters: - - clause: WHERE - subject: order_date - operator: TEMPORAL_RANGE - comparator: No filter - expressionType: SIMPLE + - clause: WHERE + comparator: No filter + expressionType: SIMPLE + operator: TEMPORAL_RANGE + subject: order_date + all_columns: + - order_date + - product_line + - status + - price_each + - sales + allow_render_html: true + annotation_layers: [] + color_pn: true + dashboards: + - 13 + datasource: 22__table + extra_form_data: {} + groupby: [] order_by_cols: [] + order_desc: true + percent_metrics: [] + query_mode: raw row_limit: 1000 server_page_length: 10 - order_desc: true - table_timestamp_format: smart_date show_cell_bars: true - color_pn: true - allow_render_html: true - extra_form_data: {} - dashboards: - - 13 -cache_timeout: null + table_timestamp_format: smart_date + temporal_columns_lookup: + order_date: true + time_grain_sqla: P1D + viz_type: table +query_context: null +slice_name: Table uuid: d0e7b367-f16f-4d7a-adde-7c7f455fa9bc version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +viz_type: table diff --git a/superset/examples/configs/charts/Featured Charts/Tree.yaml b/superset/examples/featured_charts/charts/Tree.yaml similarity index 95% rename from superset/examples/configs/charts/Featured Charts/Tree.yaml rename to superset/examples/featured_charts/charts/Tree.yaml index a1be973da91..db9ff644198 100644 --- a/superset/examples/configs/charts/Featured Charts/Tree.yaml +++ b/superset/examples/featured_charts/charts/Tree.yaml @@ -14,30 +14,32 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Tree -description: null -certified_by: null +cache_timeout: null certification_details: null -viz_type: tree_chart +certified_by: null +dataset_uuid: f710a997-c65e-4aa6-aaed-b7d6998565ae +description: null params: - datasource: 8__table - viz_type: tree_chart - id: id - parent: parent - name: name - root_node_id: "1" - metric: count adhoc_filters: [] - row_limit: 1000 - layout: radial - node_label_position: top + annotation_layers: [] child_label_position: top + dashboards: [] + datasource: 8__table + extra_form_data: {} + id: id + layout: radial + metric: count + name: name + node_label_position: top + parent: parent + roam: false + root_node_id: '1' + row_limit: 1000 symbol: emptyCircle symbolSize: 7 - roam: false - extra_form_data: {} - dashboards: [] -cache_timeout: null + viz_type: tree_chart +query_context: null +slice_name: Tree uuid: 57e7f05e-0c9a-4313-8a33-e6d0999824af version: 1.0.0 -dataset_uuid: f710a997-c65e-4aa6-aaed-b7d6998565ae +viz_type: tree_chart diff --git a/superset/examples/configs/charts/Featured Charts/Treemap.yaml b/superset/examples/featured_charts/charts/TreeMap.yaml similarity index 88% rename from superset/examples/configs/charts/Featured Charts/Treemap.yaml rename to superset/examples/featured_charts/charts/TreeMap.yaml index b959963c203..493dcefff72 100644 --- a/superset/examples/configs/charts/Featured Charts/Treemap.yaml +++ b/superset/examples/featured_charts/charts/TreeMap.yaml @@ -14,35 +14,36 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: TreeMap -description: null -certified_by: null +cache_timeout: null certification_details: null -viz_type: treemap_v2 +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null params: - datasource: 23__table - viz_type: treemap_v2 - groupby: - - year - - product_line - metric: count - row_limit: 10000 adhoc_filters: - - clause: WHERE - subject: order_date - operator: TEMPORAL_RANGE - comparator: No filter - expressionType: SIMPLE + - clause: WHERE + comparator: No filter + expressionType: SIMPLE + operator: TEMPORAL_RANGE + subject: order_date + annotation_layers: [] color_scheme: supersetColors - show_labels: true - show_upper_labels: true - label_type: key_value - number_format: SMART_NUMBER + dashboards: [] + datasource: 23__table date_format: smart_date extra_form_data: {} - dashboards: [] + groupby: + - year + - product_line + label_type: key_value + metric: count + number_format: SMART_NUMBER + row_limit: 10000 + show_labels: true + show_upper_labels: true + viz_type: treemap_v2 query_context: null -cache_timeout: null +slice_name: TreeMap uuid: 36367ecc-e09a-4c9f-80df-5dbaf97f741f version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +viz_type: treemap_v2 diff --git a/superset/examples/configs/charts/Featured Charts/Waterfall.yaml b/superset/examples/featured_charts/charts/Waterfall.yaml similarity index 92% rename from superset/examples/configs/charts/Featured Charts/Waterfall.yaml rename to superset/examples/featured_charts/charts/Waterfall.yaml index 6c79ea1c7c9..309e57c8760 100644 --- a/superset/examples/configs/charts/Featured Charts/Waterfall.yaml +++ b/superset/examples/featured_charts/charts/Waterfall.yaml @@ -14,19 +14,36 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Waterfall -description: null -certified_by: null +cache_timeout: null certification_details: null -viz_type: waterfall +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null params: - datasource: 22__table - viz_type: waterfall - x_axis: order_date - time_grain_sqla: P3M - groupby: [] - metric: + adhoc_filters: + - clause: WHERE + comparator: No filter expressionType: SIMPLE + operator: TEMPORAL_RANGE + subject: order_date + annotation_layers: [] + dashboards: + - 13 + datasource: 22__table + decrease_color: + a: 1 + b: 85 + g: 67 + r: 224 + extra_form_data: {} + groupby: [] + increase_color: + a: 1 + b: 137 + g: 193 + r: 90 + metric: + aggregate: SUM column: advanced_data_type: null certification_details: null @@ -44,42 +61,27 @@ params: type_generic: 0 verbose_name: null warning_markdown: null - aggregate: SUM - sqlExpression: null datasourceWarning: false + expressionType: SIMPLE hasCustomLabel: false label: SUM(sales) optionName: metric_uufmfvmm7_zhsh1h4vbh - adhoc_filters: - - clause: WHERE - subject: order_date - operator: TEMPORAL_RANGE - comparator: No filter - expressionType: SIMPLE + sqlExpression: null row_limit: 10000 show_value: true - increase_color: - r: 90 - g: 193 - b: 137 - a: 1 - decrease_color: - r: 224 - g: 67 - b: 85 - a: 1 + time_grain_sqla: P3M total_color: - r: 102 - g: 102 - b: 102 a: 1 + b: 102 + g: 102 + r: 102 + viz_type: waterfall + x_axis: order_date x_axis_time_format: smart_date x_ticks_layout: auto y_axis_format: SMART_NUMBER - extra_form_data: {} - dashboards: - - 13 -cache_timeout: null +query_context: null +slice_name: Waterfall uuid: 97c77c60-0613-4066-aec7-a9c6a75ad8d8 version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +viz_type: waterfall diff --git a/superset/examples/configs/charts/Featured Charts/Word_Cloud.yaml b/superset/examples/featured_charts/charts/Word_Cloud.yaml similarity index 87% rename from superset/examples/configs/charts/Featured Charts/Word_Cloud.yaml rename to superset/examples/featured_charts/charts/Word_Cloud.yaml index da984f83317..dc00bf44140 100644 --- a/superset/examples/configs/charts/Featured Charts/Word_Cloud.yaml +++ b/superset/examples/featured_charts/charts/Word_Cloud.yaml @@ -14,31 +14,33 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Word Cloud -description: null -certified_by: null +cache_timeout: null certification_details: null -viz_type: word_cloud +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null params: - datasource: 22__table - viz_type: word_cloud - series: customer_name - metric: count adhoc_filters: - - clause: WHERE - subject: order_date - operator: TEMPORAL_RANGE - comparator: No filter - expressionType: SIMPLE + - clause: WHERE + comparator: No filter + expressionType: SIMPLE + operator: TEMPORAL_RANGE + subject: order_date + annotation_layers: [] + color_scheme: supersetColors + dashboards: + - 13 + datasource: 22__table + extra_form_data: {} + metric: count + rotation: square row_limit: 100 + series: customer_name size_from: 10 size_to: 70 - rotation: square - color_scheme: supersetColors - extra_form_data: {} - dashboards: - - 13 -cache_timeout: null + viz_type: word_cloud +query_context: null +slice_name: Word Cloud uuid: d3967f7d-58ea-43fe-9961-7e061affdb1c version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +viz_type: word_cloud diff --git a/superset/examples/configs/dashboards/Featured_Charts.yaml b/superset/examples/featured_charts/dashboard.yaml similarity index 73% rename from superset/examples/configs/dashboards/Featured_Charts.yaml rename to superset/examples/featured_charts/dashboard.yaml index a0e3fe9d3f4..c61eecfa1b8 100644 --- a/superset/examples/configs/dashboards/Featured_Charts.yaml +++ b/superset/examples/featured_charts/dashboard.yaml @@ -14,132 +14,143 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. +certification_details: '' +certified_by: '' +css: '' dashboard_title: Featured Charts description: null -css: "" -slug: null -certified_by: "" -certification_details: "" -published: false -uuid: 9992d759-90d7-4d2a-b34d-373a8aaa9889 +metadata: + chart_configuration: {} + color_scheme: supersetAndPresetColors + color_scheme_domain: [] + cross_filters_enabled: true + default_filters: '{}' + expanded_slices: {} + global_chart_configuration: {} + label_colors: {} + map_label_colors: {} + native_filter_configuration: [] + refresh_frequency: 0 + shared_label_colors: [] + timed_refresh_immune_slices: [] position: CHART-2Z41H9ulKK: children: [] id: CHART-2Z41H9ulKK meta: - chartId: 107 + chartId: 95 height: 50 sliceName: Big Number with Trendline uuid: 281656a3-3d8d-4423-8b58-b050d59fadd9 width: 4 parents: - - ROOT_ID - - GRID_ID - - ROW-UvMsszSUji + - ROOT_ID + - GRID_ID + - ROW-UvMsszSUji type: CHART CHART-33vjmwrGX1: children: [] id: CHART-33vjmwrGX1 meta: - chartId: 127 + chartId: 88 height: 50 sliceName: Sunburst uuid: 47b26af7-19e0-4ca1-9cf6-b74b2f1f7e3c width: 4 parents: - - ROOT_ID - - GRID_ID - - ROW-3XARWMYOfz + - ROOT_ID + - GRID_ID + - ROW-3XARWMYOfz type: CHART CHART-3tEC_8e-uS: children: [] id: CHART-3tEC_8e-uS meta: - chartId: 109 + chartId: 94 height: 50 sliceName: Table uuid: d0e7b367-f16f-4d7a-adde-7c7f455fa9bc width: 4 parents: - - ROOT_ID - - GRID_ID - - ROW-3XARWMYOfz + - ROOT_ID + - GRID_ID + - ROW-3XARWMYOfz type: CHART CHART-4Zm6Q1VGY5: children: [] id: CHART-4Zm6Q1VGY5 meta: - chartId: 125 + chartId: 110 height: 50 sliceName: Mixed uuid: bb394e7b-0cfc-47ba-b067-541964545752 width: 4 parents: - - ROOT_ID - - GRID_ID - - ROW-UxgGmS9gb3 + - ROOT_ID + - GRID_ID + - ROW-UxgGmS9gb3 type: CHART CHART-4iGGk_pxEN: children: [] id: CHART-4iGGk_pxEN meta: - chartId: 108 + chartId: 105 height: 50 sliceName: Big Number uuid: 5adc2abe-bfa3-4091-9838-4a470031208c width: 4 parents: - - ROOT_ID - - GRID_ID - - ROW-LIWnqpnIk5 + - ROOT_ID + - GRID_ID + - ROW-LIWnqpnIk5 type: CHART CHART-A4qrvR24Ne: children: [] id: CHART-A4qrvR24Ne meta: - chartId: 128 + chartId: 111 height: 50 sliceName: Tree uuid: 57e7f05e-0c9a-4313-8a33-e6d0999824af width: 4 parents: - - ROOT_ID - - GRID_ID - - ROW-3XARWMYOfz + - ROOT_ID + - GRID_ID + - ROW-3XARWMYOfz type: CHART CHART-AFzv0kyWG_: children: [] id: CHART-AFzv0kyWG_ meta: - chartId: 115 + chartId: 103 height: 50 sliceName: Pie uuid: 02ed54c5-dc22-468c-9edf-729b5401b182 width: 4 parents: - - ROOT_ID - - GRID_ID - - ROW-UxgGmS9gb3 + - ROOT_ID + - GRID_ID + - ROW-UxgGmS9gb3 type: CHART CHART-CR0-igYucm: children: [] id: CHART-CR0-igYucm meta: - chartId: 118 + chartId: 108 height: 50 sliceName: Heatmap uuid: c99dbe37-50da-4067-837c-3a8e5b68aafd width: 4 parents: - - ROOT_ID - - GRID_ID - - ROW-cUv-aKn4Yt + - ROOT_ID + - GRID_ID + - ROW-cUv-aKn4Yt type: CHART CHART-Df3UIo8Y9s: children: [] id: CHART-Df3UIo8Y9s meta: - chartId: 1495 + chartId: 107 height: 50 sliceName: Gantt uuid: c91c242e-ec16-43e4-84fd-1c69336e0a99 @@ -153,241 +164,241 @@ position: children: [] id: CHART-DqaJJ8Fse6 meta: - chartId: 9 + chartId: 101 height: 50 sliceName: Treemap uuid: 36367ecc-e09a-4c9f-80df-5dbaf97f741f width: 4 parents: - - ROOT_ID - - GRID_ID - - ROW-ux6j1ePT8I + - ROOT_ID + - GRID_ID + - ROW-ux6j1ePT8I type: CHART CHART-EpsTnvUMuW: children: [] id: CHART-EpsTnvUMuW meta: - chartId: 111 + chartId: 92 height: 50 sliceName: Line uuid: 79567e46-97f6-4cd2-8e98-4cd211389743 width: 4 parents: - - ROOT_ID - - GRID_ID - - ROW-cUv-aKn4Yt + - ROOT_ID + - GRID_ID + - ROW-cUv-aKn4Yt type: CHART CHART-Es5rxmzfgG: children: [] id: CHART-Es5rxmzfgG meta: - chartId: 113 + chartId: 90 height: 50 sliceName: Bar uuid: 7a37f7d8-6deb-4fd3-a150-01b0ff532dbd width: 4 parents: - - ROOT_ID - - GRID_ID - - ROW-LIWnqpnIk5 + - ROOT_ID + - GRID_ID + - ROW-LIWnqpnIk5 type: CHART CHART-FVeZR4VUUl: children: [] id: CHART-FVeZR4VUUl meta: - chartId: 120 + chartId: 99 height: 50 sliceName: Box Plot uuid: cc8eea37-f890-4816-8df0-b1354d7cd553 width: 4 parents: - - ROOT_ID - - GRID_ID - - ROW-UvMsszSUji + - ROOT_ID + - GRID_ID + - ROW-UvMsszSUji type: CHART CHART-GoiTIYEOOF: children: [] id: CHART-GoiTIYEOOF meta: - chartId: 121 + chartId: 109 height: 50 sliceName: Bubble uuid: c2014499-6800-43f0-908f-a2633db3ade7 width: 4 parents: - - ROOT_ID - - GRID_ID - - ROW-UvMsszSUji + - ROOT_ID + - GRID_ID + - ROW-UvMsszSUji type: CHART CHART-KE7lk61Tbt: children: [] id: CHART-KE7lk61Tbt meta: - chartId: 119 + chartId: 89 height: 50 sliceName: Word Cloud uuid: d3967f7d-58ea-43fe-9961-7e061affdb1c width: 4 parents: - - ROOT_ID - - GRID_ID - - ROW-ux6j1ePT8I + - ROOT_ID + - GRID_ID + - ROW-ux6j1ePT8I type: CHART CHART-SjTqfJNmup: children: [] id: CHART-SjTqfJNmup meta: - chartId: 124 + chartId: 91 height: 50 sliceName: Graph uuid: be39bc2e-00c0-498b-96bf-858fe2361a89 width: 4 parents: - - ROOT_ID - - GRID_ID - - ROW-W7YILGiS0- + - ROOT_ID + - GRID_ID + - ROW-W7YILGiS0- type: CHART CHART-XwFZukVv8E: children: [] id: CHART-XwFZukVv8E meta: - chartId: 117 + chartId: 112 height: 50 sliceName: Waterfall uuid: 97c77c60-0613-4066-aec7-a9c6a75ad8d8 width: 4 parents: - - ROOT_ID - - GRID_ID - - ROW-ux6j1ePT8I - type: CHART - CHART-Z3IKOwHAnY: - children: [] - id: CHART-Z3IKOwHAnY - meta: - chartId: 112 - height: 50 - sliceName: Area - uuid: 946cccb5-2101-44f5-98f8-501789a333cd - width: 4 - parents: - - ROOT_ID - - GRID_ID - - ROW-LIWnqpnIk5 - type: CHART - CHART-gfrGP3BD76: - children: [] - id: CHART-gfrGP3BD76 - meta: - chartId: 122 - height: 50 - sliceName: Funnel - uuid: 7b90545c-1aac-447d-9175-a49f508f699d - width: 4 - parents: - - ROOT_ID - - GRID_ID - - ROW-W7YILGiS0- + - ROOT_ID + - GRID_ID + - ROW-ux6j1ePT8I type: CHART CHART-Yi0u5d9otw: children: [] id: CHART-Yi0u5d9otw meta: - chartId: 359 + chartId: 104 height: 50 sliceName: Sankey uuid: fead4d46-ecb9-4fd9-8b9c-420629269c02 width: 4 parents: - - ROOT_ID - - GRID_ID - - ROW-Jq9auQfs6- + - ROOT_ID + - GRID_ID + - ROW-Jq9auQfs6- + type: CHART + CHART-Z3IKOwHAnY: + children: [] + id: CHART-Z3IKOwHAnY + meta: + chartId: 96 + height: 50 + sliceName: Area + uuid: 946cccb5-2101-44f5-98f8-501789a333cd + width: 4 + parents: + - ROOT_ID + - GRID_ID + - ROW-LIWnqpnIk5 + type: CHART + CHART-gfrGP3BD76: + children: [] + id: CHART-gfrGP3BD76 + meta: + chartId: 106 + height: 50 + sliceName: Funnel + uuid: 7b90545c-1aac-447d-9175-a49f508f699d + width: 4 + parents: + - ROOT_ID + - GRID_ID + - ROW-W7YILGiS0- type: CHART CHART-j2o9aZo4HY: children: [] id: CHART-j2o9aZo4HY meta: - chartId: 114 + chartId: 100 height: 50 sliceName: Scatter Plot uuid: 5b629855-f912-4e28-8444-56b9db83e5b3 width: 4 parents: - - ROOT_ID - - GRID_ID - - ROW-Jq9auQfs6- + - ROOT_ID + - GRID_ID + - ROW-Jq9auQfs6- type: CHART CHART-jC2_mEgWeL: children: [] id: CHART-jC2_mEgWeL meta: - chartId: 123 + chartId: 98 height: 50 sliceName: Gauge uuid: 57ccf0f1-d28a-4127-9581-7153c5a15b62 width: 4 parents: - - ROOT_ID - - GRID_ID - - ROW-W7YILGiS0- + - ROOT_ID + - GRID_ID + - ROW-W7YILGiS0- type: CHART CHART-jzyy9Sa3pS: children: [] id: CHART-jzyy9Sa3pS meta: - chartId: 110 + chartId: 93 height: 50 sliceName: Pivot Table uuid: fcf2a0cf-0079-4f59-854f-d28297b07bf0 width: 4 parents: - - ROOT_ID - - GRID_ID - - ROW-UxgGmS9gb3 + - ROOT_ID + - GRID_ID + - ROW-UxgGmS9gb3 type: CHART CHART-qZh51tuuRH: children: [] id: CHART-qZh51tuuRH meta: - chartId: 126 + chartId: 102 height: 50 sliceName: Radar uuid: 1be00870-89b8-4ba0-a451-1fe56ef89581 width: 4 parents: - - ROOT_ID - - GRID_ID - - ROW-Jq9auQfs6- + - ROOT_ID + - GRID_ID + - ROW-Jq9auQfs6- type: CHART CHART-t5t_tQe43g: children: [] id: CHART-t5t_tQe43g meta: - chartId: 130 + chartId: 97 height: 50 sliceName: Histogram uuid: 2a89c19d-d0d2-4f5e-9007-e0fb65440e80 width: 4 parents: - - ROOT_ID - - GRID_ID - - ROW-cUv-aKn4Yt + - ROOT_ID + - GRID_ID + - ROW-cUv-aKn4Yt type: CHART DASHBOARD_VERSION_KEY: v2 GRID_ID: children: - - ROW-LIWnqpnIk5 - - ROW-UvMsszSUji - - ROW-W7YILGiS0- - - ROW-cUv-aKn4Yt - - ROW-UxgGmS9gb3 - - ROW-Jq9auQfs6- - - ROW-3XARWMYOfz - - ROW-ux6j1ePT8I - - ROW-FHBKXbZT5Z + - ROW-LIWnqpnIk5 + - ROW-UvMsszSUji + - ROW-W7YILGiS0- + - ROW-cUv-aKn4Yt + - ROW-UxgGmS9gb3 + - ROW-Jq9auQfs6- + - ROW-3XARWMYOfz + - ROW-ux6j1ePT8I + - ROW-FHBKXbZT5Z id: GRID_ID parents: - - ROOT_ID + - ROOT_ID type: GRID HEADER_ID: id: HEADER_ID @@ -396,20 +407,20 @@ position: type: HEADER ROOT_ID: children: - - GRID_ID + - GRID_ID id: ROOT_ID type: ROOT ROW-3XARWMYOfz: children: - - CHART-Yi0u5d9otw - - CHART-33vjmwrGX1 - - CHART-3tEC_8e-uS + - CHART-Yi0u5d9otw + - CHART-33vjmwrGX1 + - CHART-3tEC_8e-uS id: ROW-3XARWMYOfz meta: background: BACKGROUND_TRANSPARENT parents: - - ROOT_ID - - GRID_ID + - ROOT_ID + - GRID_ID type: ROW ROW-FHBKXbZT5Z: children: @@ -418,98 +429,94 @@ position: meta: background: BACKGROUND_TRANSPARENT parents: - - ROOT_ID - - GRID_ID + - ROOT_ID + - GRID_ID type: ROW ROW-Jq9auQfs6-: children: - - CHART-jzyy9Sa3pS - - CHART-qZh51tuuRH - - CHART-j2o9aZo4HY + - CHART-jzyy9Sa3pS + - CHART-qZh51tuuRH + - CHART-j2o9aZo4HY id: ROW-Jq9auQfs6- meta: background: BACKGROUND_TRANSPARENT parents: - - ROOT_ID - - GRID_ID + - ROOT_ID + - GRID_ID type: ROW ROW-LIWnqpnIk5: children: - - CHART-Z3IKOwHAnY - - CHART-Es5rxmzfgG - - CHART-4iGGk_pxEN + - CHART-Z3IKOwHAnY + - CHART-Es5rxmzfgG + - CHART-4iGGk_pxEN id: ROW-LIWnqpnIk5 meta: background: BACKGROUND_TRANSPARENT parents: - - ROOT_ID - - GRID_ID + - ROOT_ID + - GRID_ID type: ROW ROW-UvMsszSUji: children: - - CHART-2Z41H9ulKK - - CHART-FVeZR4VUUl - - CHART-GoiTIYEOOF + - CHART-2Z41H9ulKK + - CHART-FVeZR4VUUl + - CHART-GoiTIYEOOF id: ROW-UvMsszSUji meta: background: BACKGROUND_TRANSPARENT parents: - - ROOT_ID - - GRID_ID + - ROOT_ID + - GRID_ID type: ROW ROW-UxgGmS9gb3: children: - - CHART-EpsTnvUMuW - - CHART-4Zm6Q1VGY5 - - CHART-AFzv0kyWG_ + - CHART-EpsTnvUMuW + - CHART-4Zm6Q1VGY5 + - CHART-AFzv0kyWG_ id: ROW-UxgGmS9gb3 meta: background: BACKGROUND_TRANSPARENT parents: - - ROOT_ID - - GRID_ID + - ROOT_ID + - GRID_ID type: ROW ROW-W7YILGiS0-: children: - - CHART-gfrGP3BD76 - - CHART-Df3UIo8Y9s - - CHART-jC2_mEgWeL + - CHART-gfrGP3BD76 + - CHART-Df3UIo8Y9s + - CHART-jC2_mEgWeL id: ROW-W7YILGiS0- meta: background: BACKGROUND_TRANSPARENT parents: - - ROOT_ID - - GRID_ID + - ROOT_ID + - GRID_ID type: ROW ROW-cUv-aKn4Yt: children: - - CHART-SjTqfJNmup - - CHART-CR0-igYucm - - CHART-t5t_tQe43g + - CHART-SjTqfJNmup + - CHART-CR0-igYucm + - CHART-t5t_tQe43g id: ROW-cUv-aKn4Yt meta: background: BACKGROUND_TRANSPARENT parents: - - ROOT_ID - - GRID_ID + - ROOT_ID + - GRID_ID type: ROW ROW-ux6j1ePT8I: children: - - CHART-A4qrvR24Ne - - CHART-DqaJJ8Fse6 - - CHART-XwFZukVv8E + - CHART-A4qrvR24Ne + - CHART-DqaJJ8Fse6 + - CHART-XwFZukVv8E id: ROW-ux6j1ePT8I meta: background: BACKGROUND_TRANSPARENT parents: - - ROOT_ID - - GRID_ID + - ROOT_ID + - GRID_ID type: ROW -metadata: - color_scheme: supersetAndPresetColors - refresh_frequency: 0 - expanded_slices: {} - label_colors: {} - timed_refresh_immune_slices: [] - cross_filters_enabled: true +published: true +slug: null +uuid: 9992d759-90d7-4d2a-b34d-373a8aaa9889 version: 1.0.0 diff --git a/superset/examples/featured_charts/data/cleaned_sales_data.parquet b/superset/examples/featured_charts/data/cleaned_sales_data.parquet new file mode 100644 index 00000000000..1b50e80b669 Binary files /dev/null and b/superset/examples/featured_charts/data/cleaned_sales_data.parquet differ diff --git a/superset/examples/featured_charts/data/hierarchical_dataset.parquet b/superset/examples/featured_charts/data/hierarchical_dataset.parquet new file mode 100644 index 00000000000..86c5cf886cf Binary files /dev/null and b/superset/examples/featured_charts/data/hierarchical_dataset.parquet differ diff --git a/superset/examples/featured_charts/data/project_management.parquet b/superset/examples/featured_charts/data/project_management.parquet new file mode 100644 index 00000000000..0c36ea951c4 Binary files /dev/null and b/superset/examples/featured_charts/data/project_management.parquet differ diff --git a/superset/examples/configs/datasets/examples/cleaned_sales_data.yaml b/superset/examples/featured_charts/datasets/cleaned_sales_data.yaml similarity index 81% rename from superset/examples/configs/datasets/examples/cleaned_sales_data.yaml rename to superset/examples/featured_charts/datasets/cleaned_sales_data.yaml index 35bb522ef81..fe0f4063f51 100644 --- a/superset/examples/configs/datasets/examples/cleaned_sales_data.yaml +++ b/superset/examples/featured_charts/datasets/cleaned_sales_data.yaml @@ -14,334 +14,335 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -table_name: cleaned_sales_data -main_dttm_col: order_date -description: null -default_endpoint: null -offset: 0 +always_filter_main_dttm: false cache_timeout: null catalog: null +columns: +- advanced_data_type: null + column_name: order_date + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: true + python_date_format: null + type: TIMESTAMP WITHOUT TIME ZONE + verbose_name: null +- advanced_data_type: null + column_name: price_each + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: sales + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: address_line1 + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: address_line2 + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: order_line_number + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: quantity_ordered + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: order_number + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: quarter + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: year + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: month + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: msrp + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: contact_last_name + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: contact_first_name + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: postal_code + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: customer_name + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: deal_size + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: product_code + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: product_line + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: state + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: status + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: city + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: country + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: phone + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: territory + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +data_file: cleaned_sales_data.parquet +database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee +default_endpoint: null +description: null +extra: null +fetch_values_predicate: null +filter_select_enabled: true +folders: null +main_dttm_col: order_date +metrics: +- currency: null + d3format: null + description: null + expression: COUNT(*) + extra: null + metric_name: count + metric_type: count + verbose_name: COUNT(*) + warning_text: null +normalize_columns: false +offset: 0 +params: null schema: null sql: null -params: null +table_name: cleaned_sales_data template_params: null -filter_select_enabled: true -fetch_values_predicate: null -extra: null -normalize_columns: false -always_filter_main_dttm: false uuid: e8623bb9-5e00-f531-506a-19607f5f8005 -metrics: -- metric_name: count - verbose_name: COUNT(*) - metric_type: count - expression: COUNT(*) - description: null - d3format: null - currency: null - extra: null - warning_text: null -columns: -- column_name: order_date - verbose_name: null - is_dttm: true - is_active: true - type: TIMESTAMP WITHOUT TIME ZONE - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: null -- column_name: price_each - verbose_name: null - is_dttm: false - is_active: true - type: DOUBLE PRECISION - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: null -- column_name: sales - verbose_name: null - is_dttm: false - is_active: true - type: DOUBLE PRECISION - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: null -- column_name: address_line1 - verbose_name: null - is_dttm: false - is_active: true - type: TEXT - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: null -- column_name: address_line2 - verbose_name: null - is_dttm: false - is_active: true - type: TEXT - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: null -- column_name: order_line_number - verbose_name: null - is_dttm: false - is_active: true - type: BIGINT - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: null -- column_name: quantity_ordered - verbose_name: null - is_dttm: false - is_active: true - type: BIGINT - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: null -- column_name: order_number - verbose_name: null - is_dttm: false - is_active: true - type: BIGINT - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: null -- column_name: quarter - verbose_name: null - is_dttm: false - is_active: true - type: BIGINT - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: null -- column_name: year - verbose_name: null - is_dttm: false - is_active: true - type: BIGINT - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: null -- column_name: month - verbose_name: null - is_dttm: false - is_active: true - type: BIGINT - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: null -- column_name: msrp - verbose_name: null - is_dttm: false - is_active: true - type: BIGINT - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: null -- column_name: contact_last_name - verbose_name: null - is_dttm: false - is_active: true - type: TEXT - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: null -- column_name: contact_first_name - verbose_name: null - is_dttm: false - is_active: true - type: TEXT - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: null -- column_name: postal_code - verbose_name: null - is_dttm: false - is_active: true - type: TEXT - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: null -- column_name: customer_name - verbose_name: null - is_dttm: false - is_active: true - type: TEXT - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: null -- column_name: deal_size - verbose_name: null - is_dttm: false - is_active: true - type: TEXT - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: null -- column_name: product_code - verbose_name: null - is_dttm: false - is_active: true - type: TEXT - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: null -- column_name: product_line - verbose_name: null - is_dttm: false - is_active: true - type: TEXT - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: null -- column_name: state - verbose_name: null - is_dttm: false - is_active: true - type: TEXT - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: null -- column_name: status - verbose_name: null - is_dttm: false - is_active: true - type: TEXT - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: null -- column_name: city - verbose_name: null - is_dttm: false - is_active: true - type: TEXT - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: null -- column_name: country - verbose_name: null - is_dttm: false - is_active: true - type: TEXT - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: null -- column_name: phone - verbose_name: null - is_dttm: false - is_active: true - type: TEXT - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: null -- column_name: territory - verbose_name: null - is_dttm: false - is_active: true - type: TEXT - advanced_data_type: null - groupby: true - filterable: true - expression: null - description: null - python_date_format: null - extra: null version: 1.0.0 -database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee -data: examples://datasets/examples/sales.csv diff --git a/superset/examples/featured_charts/datasets/hierarchical_dataset.yaml b/superset/examples/featured_charts/datasets/hierarchical_dataset.yaml new file mode 100644 index 00000000000..8baee9b9b35 --- /dev/null +++ b/superset/examples/featured_charts/datasets/hierarchical_dataset.yaml @@ -0,0 +1,96 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +always_filter_main_dttm: false +cache_timeout: null +catalog: null +columns: +- advanced_data_type: null + column_name: parent + description: null + expression: null + extra: '{}' + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: INTEGER + verbose_name: null +- advanced_data_type: null + column_name: count + description: null + expression: null + extra: '{}' + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: INTEGER + verbose_name: null +- advanced_data_type: null + column_name: id + description: null + expression: null + extra: '{}' + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: INTEGER + verbose_name: null +- advanced_data_type: null + column_name: name + description: null + expression: null + extra: '{}' + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: STRING + verbose_name: null +data_file: hierarchical_dataset.parquet +database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee +default_endpoint: null +description: null +extra: null +fetch_values_predicate: null +filter_select_enabled: true +folders: null +main_dttm_col: null +metrics: +- currency: null + d3format: null + description: null + expression: COUNT(*) + extra: '{"warning_markdown": ""}' + metric_name: count + metric_type: count + verbose_name: COUNT(*) + warning_text: null +normalize_columns: false +offset: 0 +params: null +schema: null +sql: null +table_name: hierarchical_dataset +template_params: null +uuid: f710a997-c65e-4aa6-aaed-b7d6998565ae +version: 1.0.0 diff --git a/superset/examples/featured_charts/datasets/project_management.yaml b/superset/examples/featured_charts/datasets/project_management.yaml new file mode 100644 index 00000000000..c7f20499246 --- /dev/null +++ b/superset/examples/featured_charts/datasets/project_management.yaml @@ -0,0 +1,132 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +always_filter_main_dttm: false +cache_timeout: null +catalog: examples +columns: +- advanced_data_type: null + column_name: start_time + description: null + expression: null + extra: '{}' + filterable: true + groupby: true + is_active: true + is_dttm: true + python_date_format: null + type: LONGINTEGER + verbose_name: null +- advanced_data_type: null + column_name: end_time + description: null + expression: null + extra: '{}' + filterable: true + groupby: true + is_active: true + is_dttm: true + python_date_format: null + type: LONGINTEGER + verbose_name: null +- advanced_data_type: null + column_name: phase + description: null + expression: null + extra: '{}' + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: STRING + verbose_name: null +- advanced_data_type: null + column_name: status + description: null + expression: null + extra: '{}' + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: STRING + verbose_name: null +- advanced_data_type: null + column_name: description + description: null + expression: null + extra: '{}' + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: STRING + verbose_name: null +- advanced_data_type: null + column_name: project + description: null + expression: null + extra: '{}' + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: STRING + verbose_name: null +- advanced_data_type: null + column_name: priority + description: null + expression: null + extra: '{}' + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: STRING + verbose_name: null +data_file: project_management.parquet +database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee +default_endpoint: null +description: null +extra: null +fetch_values_predicate: null +filter_select_enabled: true +folders: null +main_dttm_col: start_time +metrics: +- currency: null + d3format: null + description: null + expression: COUNT(*) + extra: '{"warning_markdown": ""}' + metric_name: count + metric_type: count + verbose_name: COUNT(*) + warning_text: null +normalize_columns: false +offset: 0 +params: null +schema: null +sql: null +table_name: project_management +template_params: null +uuid: d638a239-f255-44fc-b0c1-c3f3b7f00ee0 +version: 1.0.0 diff --git a/superset/examples/flights.py b/superset/examples/flights.py deleted file mode 100644 index db00ff5b3ac..00000000000 --- a/superset/examples/flights.py +++ /dev/null @@ -1,76 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -import logging - -import pandas as pd -from sqlalchemy import DateTime, inspect - -import superset.utils.database as database_utils -from superset import db -from superset.sql.parse import Table - -from .helpers import get_table_connector_registry, read_example_data - -logger = logging.getLogger(__name__) - - -def load_flights(only_metadata: bool = False, force: bool = False) -> None: - """Loading random time series data from a zip file in the repo""" - tbl_name = "flights" - database = database_utils.get_example_database() - with database.get_sqla_engine() as engine: - schema = inspect(engine).default_schema_name - table_exists = database.has_table(Table(tbl_name, schema)) - - if not only_metadata and (not table_exists or force): - pdf = read_example_data( - "examples://flight_data.csv.gz", encoding="latin-1", compression="gzip" - ) - - # Loading airports info to join and get lat/long - airports = read_example_data( - "examples://airports.csv.gz", encoding="latin-1", compression="gzip" - ) - airports = airports.set_index("IATA_CODE") - - pdf["ds"] = ( - pdf.YEAR.map(str) + "-0" + pdf.MONTH.map(str) + "-0" + pdf.DAY.map(str) - ) - pdf.ds = pd.to_datetime(pdf.ds) - pdf.drop(columns=["DAY", "MONTH", "YEAR"]) - pdf = pdf.join(airports, on="ORIGIN_AIRPORT", rsuffix="_ORIG") - pdf = pdf.join(airports, on="DESTINATION_AIRPORT", rsuffix="_DEST") - pdf.to_sql( - tbl_name, - engine, - schema=schema, - if_exists="replace", - chunksize=500, - dtype={"ds": DateTime}, - index=False, - ) - - table = get_table_connector_registry() - tbl = db.session.query(table).filter_by(table_name=tbl_name).first() - if not tbl: - tbl = table(table_name=tbl_name, schema=schema) - db.session.add(tbl) - tbl.description = "Random set of flights in the US" - tbl.database = database - tbl.filter_select_enabled = True - tbl.fetch_metadata() - logger.debug("Done loading table!") diff --git a/superset/examples/generic_loader.py b/superset/examples/generic_loader.py new file mode 100644 index 00000000000..220e6939524 --- /dev/null +++ b/superset/examples/generic_loader.py @@ -0,0 +1,244 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +"""Generic Parquet example data loader.""" + +import logging +from functools import partial +from typing import Any, Callable, Optional + +import numpy as np +from sqlalchemy import inspect + +from superset import db +from superset.connectors.sqla.models import SqlaTable +from superset.examples.helpers import read_example_data +from superset.models.core import Database +from superset.sql.parse import Table +from superset.utils import json +from superset.utils.database import get_example_database + +logger = logging.getLogger(__name__) + + +def serialize_numpy_arrays(obj: Any) -> Any: # noqa: C901 + """Convert numpy arrays to JSON-serializable format.""" + if isinstance(obj, np.ndarray): + return obj.tolist() + elif isinstance(obj, np.generic): + # Handle numpy scalar types + return obj.item() + elif isinstance(obj, (list, tuple)): + return [serialize_numpy_arrays(item) for item in obj] + elif isinstance(obj, dict): + return {key: serialize_numpy_arrays(val) for key, val in obj.items()} + return obj + + +def load_parquet_table( # noqa: C901 + parquet_file: str, + table_name: str, + database: Optional[Database] = None, + only_metadata: bool = False, + force: bool = False, + sample_rows: Optional[int] = None, + data_file: Optional[Any] = None, + schema: Optional[str] = None, +) -> SqlaTable: + """Load a Parquet file into the example database. + + Args: + parquet_file: Name of the Parquet file (e.g., "birth_names") + table_name: Name for the table in the target database + database: Target database (defaults to example database) + only_metadata: If True, only create metadata without loading data + force: If True, replace existing table + sample_rows: If specified, only load this many rows + data_file: Optional specific file path (Path object) to load from + schema: Schema to load into (defaults to database default schema) + + Returns: + The created SqlaTable object + """ + from sqlalchemy import text + + if database is None: + database = get_example_database() + + # Determine schema - use provided or fall back to database default + with database.get_sqla_engine() as engine: + if schema is None: + schema = inspect(engine).default_schema_name + else: + # Create schema if it doesn't exist (PostgreSQL) + with engine.begin() as conn: + conn.execute(text(f'CREATE SCHEMA IF NOT EXISTS "{schema}"')) + + table_exists = database.has_table(Table(table_name, schema=schema)) + if table_exists and not force: + logger.info("Table %s already exists, skipping data load", table_name) + tbl = ( + db.session.query(SqlaTable) + .filter_by(table_name=table_name, database_id=database.id) + .first() + ) + if tbl: + return tbl + + # Load data if not metadata only + if not only_metadata: + logger.info("Loading data for %s from %s.parquet", table_name, parquet_file) + + # Read from Parquet - use specific file path if provided + if data_file is not None: + pdf = read_example_data(f"file://{data_file}") + else: + pdf = read_example_data(f"examples://{parquet_file}") + + # Sample if requested (handle sample_rows=0 correctly) + if sample_rows is not None: + pdf = pdf.head(sample_rows) + + # Check for columns with complex types (numpy arrays, nested structures) + for col in pdf.columns: + # Check if any value in the column is a numpy array or nested structure + if pdf[col].dtype == object: + try: + # Check if the first non-null value is complex + sample_val = ( + pdf[col].dropna().iloc[0] + if not pdf[col].dropna().empty + else None + ) + if sample_val is not None and isinstance( + sample_val, (np.ndarray, list, dict) + ): + logger.info("Converting complex column %s to JSON string", col) + + # Convert to JSON string for database storage + def safe_serialize(x: Any, column_name: str) -> Optional[str]: + if x is None: + return None + try: + return json.dumps(serialize_numpy_arrays(x)) + except (TypeError, ValueError) as e: + logger.warning( + "Failed to serialize value in column %s: %s", + column_name, + e, + ) + # Convert to string representation as fallback + return str(x) + + # Avoid loop variable binding issues with partial + serialize_col = partial(safe_serialize, column_name=col) + pdf[col] = pdf[col].apply(serialize_col) + except Exception as e: + logger.warning("Could not process column %s: %s", col, e) + + # Write to target database + with database.get_sqla_engine() as engine: + pdf.to_sql( + table_name, + engine, + schema=schema, + if_exists="replace", + chunksize=500, + method="multi", + index=False, + ) + + logger.info("Loaded %d rows into %s", len(pdf), table_name) + + # Create or update SqlaTable metadata + tbl = ( + db.session.query(SqlaTable) + .filter_by(table_name=table_name, database_id=database.id) + .first() + ) + + if not tbl: + tbl = SqlaTable(table_name=table_name, database_id=database.id) + # Set the database reference + tbl.database = database + + if not only_metadata: + # Ensure database reference is set before fetching metadata + if not tbl.database: + tbl.database = database + tbl.fetch_metadata() + + db.session.merge(tbl) + db.session.commit() + + return tbl + + +def create_generic_loader( + parquet_file: str, + table_name: Optional[str] = None, + description: Optional[str] = None, + sample_rows: Optional[int] = None, + data_file: Optional[Any] = None, + schema: Optional[str] = None, +) -> Callable[[Database, SqlaTable], None]: + """Create a loader function for a specific Parquet file. + + This factory function creates loaders that match the existing pattern + used by Superset examples. + + Args: + parquet_file: Name of the Parquet file (without .parquet extension) + table_name: Table name (defaults to parquet_file) + description: Description for the dataset + sample_rows: Default number of rows to sample + data_file: Optional specific file path (Path object) for data/ folder pattern + schema: Schema to load into (defaults to database default schema) + + Returns: + A loader function with the standard signature + """ + if table_name is None: + table_name = parquet_file + + def loader( + only_metadata: bool = False, + force: bool = False, + sample: bool = False, + ) -> None: + """Load the dataset.""" + rows = sample_rows if sample and sample_rows is not None else None + + tbl = load_parquet_table( + parquet_file=parquet_file, + table_name=table_name, + only_metadata=only_metadata, + force=force, + sample_rows=rows, + data_file=data_file, + schema=schema, + ) + + if description and tbl: + tbl.description = description + db.session.merge(tbl) + db.session.commit() + + # Set function name and docstring + loader.__name__ = f"load_{parquet_file}" + loader.__doc__ = description or f"Load {parquet_file} dataset" + + return loader diff --git a/superset/examples/helpers.py b/superset/examples/helpers.py index c10cd0f36bd..73e7344bc00 100644 --- a/superset/examples/helpers.py +++ b/superset/examples/helpers.py @@ -16,36 +16,16 @@ # under the License. """Helpers for loading Superset example datasets. -All Superset example data files (CSV, JSON, etc.) are fetched via the -jsDelivr CDN instead of raw.githubusercontent.com to avoid GitHub API -rate limits (60 anonymous requests/hour/IP). +Example datasets are stored as Parquet files organized by example name: + superset/examples/{example_name}/data.parquet -jsDelivr is a multi‑CDN front for public GitHub repos and supports -arbitrary paths including nested folders. It doesn’t use the GitHub REST API -and advertises unlimited bandwidth for open-source use. - -Example URL:: - - https://cdn.jsdelivr.net/gh/apache-superset/examples-data@master/datasets/examples/slack/messages.csv - -Environment knobs ------------------ -``SUPERSET_EXAMPLES_DATA_REF`` (default: ``master``) - Tag / branch / SHA to pin so builds remain reproducible. - -``SUPERSET_EXAMPLES_BASE_URL`` - Override the base completely if you want to host the files elsewhere - (internal mirror, S3 bucket, ASF downloads, …). **Include any query - string required by your hosting (e.g. ``?raw=true`` if you point back - to a GitHub *blob* URL).** +Parquet is an Apache-friendly, compressed columnar format. """ from __future__ import annotations import os -import time from typing import Any -from urllib.error import HTTPError import pandas as pd from flask import current_app @@ -57,15 +37,6 @@ from superset.utils import json EXAMPLES_PROTOCOL = "examples://" -# --------------------------------------------------------------------------- -# Public sample‑data mirror configuration -# --------------------------------------------------------------------------- -BASE_COMMIT: str = os.getenv("SUPERSET_EXAMPLES_DATA_REF", "master") -BASE_URL: str = os.getenv( - "SUPERSET_EXAMPLES_BASE_URL", - f"https://cdn.jsdelivr.net/gh/apache-superset/examples-data@{BASE_COMMIT}/", -) - # Slices assembled into a 'Misc Chart' dashboard misc_dash_slices: set[str] = set() @@ -119,52 +90,98 @@ def get_slice_json(defaults: dict[Any, Any], **kwargs: Any) -> str: return json.dumps(defaults_copy, indent=4, sort_keys=True) -def get_example_url(filepath: str) -> str: - """Return an absolute URL to *filepath* under the examples‑data repo. - - All calls are routed through jsDelivr unless overridden. Supports nested - paths like ``datasets/examples/slack/messages.csv``. - """ - return f"{BASE_URL}{filepath}" - - def normalize_example_data_url(url: str) -> str: - """Convert example data URLs to use the configured CDN. + """Normalize example data URLs for consistency. - Transforms examples:// URLs to the configured CDN URL. - Non-example URLs are returned unchanged. + This function ensures that example data URLs are properly formatted. + Since the schema validator expects valid URLs and our examples:// protocol + isn't standard, we convert to file:// URLs pointing to the actual location. + + Args: + url: URL to normalize (e.g., "examples://birth_names") + + Returns: + Normalized file:// URL pointing to the Parquet file, or the original URL + if it's a remote URL (http://, https://, etc.) """ - if url.startswith(EXAMPLES_PROTOCOL): - relative_path = url[len(EXAMPLES_PROTOCOL) :] - return get_example_url(relative_path) + import os - # Not an examples URL, return unchanged - return url + # Handle existing examples:// protocol + if url.startswith(EXAMPLES_PROTOCOL): + # Remove the protocol for processing + example_name = url[len(EXAMPLES_PROTOCOL) :] + elif url.startswith(("file://", "http://", "https://", "s3://", "gs://")): + # Already a valid URL protocol, return as-is + return url + else: + # Assume it's a local example name + example_name = url + + # Strip any extension + for ext in (".parquet", ".csv", ".gz"): + if example_name.endswith(ext): + example_name = example_name[: -len(ext)] + break + + # Normalize name (lowercase, underscores) + example_name = example_name.lower().replace(" ", "_").replace("-", "_") + + # Build the full file path: {examples_folder}/{example_name}/data.parquet + examples_folder = get_examples_folder() + full_path = os.path.join(examples_folder, example_name, "data.parquet") + + # Security: Ensure the path doesn't traverse outside examples folder + full_path = os.path.abspath(full_path) + examples_folder = os.path.abspath(examples_folder) + if not full_path.startswith(examples_folder + os.sep): + raise ValueError(f"Invalid path: {example_name} attempts directory traversal") + + # Convert to file:// URL for schema validation + return f"file://{full_path}" def read_example_data( filepath: str, - max_attempts: int = 5, - wait_seconds: float = 60, + table_name: str | None = None, **kwargs: Any, ) -> pd.DataFrame: - """Load CSV or JSON from example data mirror with retry/backoff.""" - url = normalize_example_data_url(filepath) - is_json = filepath.endswith(".json") or filepath.endswith(".json.gz") + """Load data from local Parquet files. - for attempt in range(1, max_attempts + 1): - try: - if is_json: - return pd.read_json(url, **kwargs) - return pd.read_csv(url, **kwargs) - except HTTPError: - if attempt < max_attempts: - sleep_time = wait_seconds * (2 ** (attempt - 1)) - print( - f"HTTP 429 received from {url}. ", - f"Retrying in {sleep_time:.1f}s ", - f"(attempt {attempt}/{max_attempts})...", - ) - time.sleep(sleep_time) - else: - raise + Examples are organized as: + superset/examples/{example_name}/data.parquet + + Args: + filepath: Example name (e.g., "examples://birth_names" or just "birth_names") + table_name: Ignored (kept for backward compatibility) + **kwargs: Ignored (kept for backward compatibility) + + Returns: + DataFrame with the loaded data + """ + import os + + # Extract example name from filepath + if filepath.startswith(EXAMPLES_PROTOCOL): + example_name = filepath[len(EXAMPLES_PROTOCOL) :] + elif filepath.startswith("file://"): + # file:// protocol - use as-is for direct file access + return pd.read_parquet(filepath[7:]) + else: + example_name = filepath + + # Strip any extension + for ext in (".parquet", ".csv", ".gz"): + if example_name.endswith(ext): + example_name = example_name[: -len(ext)] + break + + # Normalize name (lowercase, underscores) + example_name = example_name.lower().replace(" ", "_").replace("-", "_") + + # Build path: {examples_folder}/{example_name}/data.parquet + local_path = os.path.join(get_examples_folder(), example_name, "data.parquet") + + if not os.path.exists(local_path): + raise FileNotFoundError(f"Example data file not found: {local_path}") + + return pd.read_parquet(local_path) diff --git a/superset/examples/international_sales.py b/superset/examples/international_sales.py deleted file mode 100644 index 3cfd4ed430e..00000000000 --- a/superset/examples/international_sales.py +++ /dev/null @@ -1,238 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -"""International sales dataset demonstrating multi-currency transactions.""" - -import logging - -import pandas as pd -from sqlalchemy import Date, inspect, Integer, Numeric, String - -from superset import db -from superset.connectors.sqla.models import SqlaTable -from superset.models.core import Database -from superset.sql.parse import Table - -from ..utils.database import get_example_database # noqa: TID252 -from .helpers import get_table_connector_registry - -logger = logging.getLogger(__name__) - - -def get_international_sales_data() -> pd.DataFrame: - """Generate the international sales dataset with multiple currencies.""" - # fmt: off - data = [ - # North America - USA (USD) - (1, "2024-01-15", "North America", "USA", "Electronics", "Laptop Pro", - 50, 1299.99, 64999.50, 45000.00, 19999.50, "USD", "$"), - (2, "2024-01-15", "North America", "USA", "Electronics", "Smartphone X", - 200, 899.99, 179998.00, 120000.00, 59998.00, "USD", "$"), - (3, "2024-01-15", "North America", "USA", "Software", "Office Suite", - 500, 149.99, 74995.00, 15000.00, 59995.00, "USD", "$"), - (4, "2024-02-15", "North America", "USA", "Electronics", "Laptop Pro", - 75, 1299.99, 97499.25, 67500.00, 29999.25, "USD", "$"), - (5, "2024-02-15", "North America", "USA", "Electronics", "Smartphone X", - 250, 899.99, 224997.50, 150000.00, 74997.50, "USD", "$"), - (6, "2024-02-15", "North America", "USA", "Software", "Office Suite", - 600, 149.99, 89994.00, 18000.00, 71994.00, "USD", "$"), - (7, "2024-03-15", "North America", "USA", "Electronics", "Laptop Pro", - 100, 1299.99, 129999.00, 90000.00, 39999.00, "USD", "$"), - (8, "2024-03-15", "North America", "USA", "Electronics", "Smartphone X", - 300, 899.99, 269997.00, 180000.00, 89997.00, "USD", "$"), - # Case normalization test - lowercase 'usd' - (9, "2024-03-15", "North America", "USA", "Software", "Office Suite", - 700, 149.99, 104993.00, 21000.00, 83993.00, "usd", "$"), - # North America - Canada (CAD) - (10, "2024-01-15", "North America", "Canada", "Electronics", "Laptop Pro", - 30, 1599.99, 47999.70, 35000.00, 12999.70, "CAD", "CA$"), - (11, "2024-01-15", "North America", "Canada", "Electronics", "Smartphone X", - 100, 1099.99, 109999.00, 75000.00, 34999.00, "CAD", "CA$"), - (12, "2024-02-15", "North America", "Canada", "Electronics", "Laptop Pro", - 40, 1599.99, 63999.60, 46000.00, 17999.60, "CAD", "CA$"), - (13, "2024-02-15", "North America", "Canada", "Software", "Office Suite", - 200, 199.99, 39998.00, 8000.00, 31998.00, "CAD", "CA$"), - # Case normalization test - mixed case 'Cad' - (14, "2024-03-15", "North America", "Canada", "Electronics", "Laptop Pro", - 50, 1599.99, 79999.50, 57500.00, 22499.50, "Cad", "CA$"), - # Europe - Germany/France (EUR) - (15, "2024-01-15", "Europe", "Germany", "Electronics", "Laptop Pro", - 40, 1199.99, 47999.60, 32000.00, 15999.60, "EUR", "€"), - (16, "2024-01-15", "Europe", "Germany", "Electronics", "Smartphone X", - 150, 849.99, 127498.50, 85000.00, 42498.50, "EUR", "€"), - (17, "2024-01-15", "Europe", "France", "Software", "Office Suite", - 300, 139.99, 41997.00, 9000.00, 32997.00, "EUR", "€"), - (18, "2024-02-15", "Europe", "Germany", "Electronics", "Laptop Pro", - 55, 1199.99, 65999.45, 44000.00, 21999.45, "EUR", "€"), - (19, "2024-02-15", "Europe", "France", "Electronics", "Smartphone X", - 180, 849.99, 152998.20, 102000.00, 50998.20, "EUR", "€"), - # Case normalization test - lowercase 'eur' - (20, "2024-02-15", "Europe", "Germany", "Software", "Office Suite", - 350, 139.99, 48996.50, 10500.00, 38496.50, "eur", "€"), - # Europe - UK (GBP) - (21, "2024-01-15", "Europe", "UK", "Electronics", "Laptop Pro", - 35, 999.99, 34999.65, 24500.00, 10499.65, "GBP", "£"), - (22, "2024-01-15", "Europe", "UK", "Electronics", "Smartphone X", - 120, 749.99, 89998.80, 66000.00, 23998.80, "GBP", "£"), - (23, "2024-02-15", "Europe", "UK", "Electronics", "Laptop Pro", - 45, 999.99, 44999.55, 31500.00, 13499.55, "GBP", "£"), - (24, "2024-02-15", "Europe", "UK", "Software", "Office Suite", - 250, 119.99, 29997.50, 7500.00, 22497.50, "GBP", "£"), - # Case normalization test - mixed case 'Gbp' - (25, "2024-03-15", "Europe", "UK", "Electronics", "Laptop Pro", - 60, 999.99, 59999.40, 42000.00, 17999.40, "Gbp", "£"), - # Asia - Japan (JPY) - (26, "2024-01-15", "Asia", "Japan", "Electronics", "Laptop Pro", - 25, 149999.00, 3749975.00, 2625000.00, 1124975.00, "JPY", "¥"), - (27, "2024-01-15", "Asia", "Japan", "Electronics", "Smartphone X", - 80, 99999.00, 7999920.00, 5600000.00, 2399920.00, "JPY", "¥"), - (28, "2024-02-15", "Asia", "Japan", "Electronics", "Laptop Pro", - 30, 149999.00, 4499970.00, 3150000.00, 1349970.00, "JPY", "¥"), - (29, "2024-03-15", "Asia", "Japan", "Software", "Office Suite", - 150, 14999.00, 2249850.00, 450000.00, 1799850.00, "JPY", "¥"), - # Asia Pacific - Australia (AUD) - (30, "2024-01-15", "Asia Pacific", "Australia", "Electronics", "Laptop Pro", - 20, 1899.99, 37999.80, 26000.00, 11999.80, "AUD", "A$"), - (31, "2024-02-15", "Asia Pacific", "Australia", "Electronics", "Smartphone X", - 60, 1299.99, 77999.40, 48000.00, 29999.40, "AUD", "A$"), - (32, "2024-03-15", "Asia Pacific", "Australia", "Software", "Office Suite", - 100, 219.99, 21999.00, 6000.00, 15999.00, "AUD", "A$"), - # NULL currency tests - Other region - (33, "2024-01-15", "Other", "Unknown", "Electronics", "Generic Device", - 10, 500.00, 5000.00, 3500.00, 1500.00, None, None), - (34, "2024-02-15", "Other", "Unknown", "Software", "Basic App", - 50, 50.00, 2500.00, 1000.00, 1500.00, None, None), - # Empty string currency test - (35, "2024-03-15", "Other", "Unknown", "Electronics", "Unknown Product", - 5, 100.00, 500.00, 350.00, 150.00, "", ""), - # Additional rows for aggregation tests - (36, "2024-01-15", "North America", "USA", "Electronics", "Tablet Pro", - 80, 599.99, 47999.20, 32000.00, 15999.20, "USD", "$"), - (37, "2024-02-15", "Europe", "Germany", "Electronics", "Tablet Pro", - 65, 549.99, 35749.35, 22750.00, 12999.35, "EUR", "€"), - (38, "2024-03-15", "Asia", "Japan", "Electronics", "Tablet Pro", - 45, 64999.00, 2924955.00, 1575000.00, 1349955.00, "JPY", "¥"), - # Euro word/symbol normalization tests - (39, "2024-01-15", "Europe", "Spain", "Software", "Cloud Service", - 100, 99.99, 9999.00, 5000.00, 4999.00, "euro", "€"), - (40, "2024-02-15", "Europe", "Italy", "Software", "Cloud Service", - 120, 99.99, 11998.80, 6000.00, 5998.80, "EURO", "€"), - (41, "2024-03-15", "Europe", "Portugal", "Software", "Cloud Service", - 80, 99.99, 7999.20, 4000.00, 3999.20, "€", "€"), - # Invalid currency code fallback test - (42, "2024-01-15", "Other", "Unknown", "Electronics", "Mystery Device", - 25, 200.00, 5000.00, 3000.00, 2000.00, "XYZ", "?"), - ] - # fmt: on - - columns = [ - "id", - "transaction_date", - "region", - "country", - "product_category", - "product_name", - "quantity", - "unit_price", - "revenue", - "cost", - "profit", - "currency_code", - "currency_symbol", - ] - - return pd.DataFrame(data, columns=columns) - - -def load_data(tbl_name: str, database: Database) -> None: - """Load the international sales data into the database.""" - pdf = get_international_sales_data() - pdf["transaction_date"] = pd.to_datetime(pdf["transaction_date"]) - - with database.get_sqla_engine() as engine: - schema = inspect(engine).default_schema_name - - pdf.to_sql( - tbl_name, - engine, - schema=schema, - if_exists="replace", - chunksize=50, - dtype={ - "id": Integer, - "transaction_date": Date, - "region": String(50), - "country": String(50), - "product_category": String(50), - "product_name": String(100), - "quantity": Integer, - "unit_price": Numeric(12, 2), - "revenue": Numeric(14, 2), - "cost": Numeric(14, 2), - "profit": Numeric(14, 2), - "currency_code": String(10), - "currency_symbol": String(10), - }, - method="multi", - index=False, - ) - logger.debug("Done loading international sales data!") - - -def load_international_sales(only_metadata: bool = False, force: bool = False) -> None: - """Load international sales dataset for demonstrating dynamic currency formatting. - - This dataset contains multi-currency transaction data with: - - Multiple currencies (USD, EUR, GBP, JPY, CAD, AUD) - - Case variations for normalization testing (usd, eur, Gbp, Cad) - - Word variations for normalization testing (euro, EURO) - - Symbol variations for normalization testing (€) - - NULL and empty string currency values for fallback testing - - Invalid currency code (XYZ) for fallback testing - - Multiple monetary columns (revenue, cost, profit, unit_price) - """ - database = get_example_database() - tbl_name = "international_sales" - - with database.get_sqla_engine() as engine: - schema = inspect(engine).default_schema_name - table_exists = database.has_table(Table(tbl_name, schema)) - - if not only_metadata and (not table_exists or force): - load_data(tbl_name, database) - - table = get_table_connector_registry() - obj = db.session.query(table).filter_by(table_name=tbl_name, schema=schema).first() - if not obj: - logger.debug("Creating table [%s] reference", tbl_name) - obj = table(table_name=tbl_name, schema=schema) - db.session.add(obj) - - _set_table_metadata(obj, database) - - -def _set_table_metadata(datasource: SqlaTable, database: Database) -> None: - """Set metadata for the international sales dataset.""" - datasource.main_dttm_col = "transaction_date" - datasource.database = database - datasource.filter_select_enabled = True - datasource.description = ( - "International sales transactions across multiple currencies " - "for demonstrating dynamic currency formatting features." - ) - # Set the currency code column for dynamic currency detection - datasource.currency_code_column = "currency_code" - datasource.fetch_metadata() diff --git a/superset/examples/international_sales/data.parquet b/superset/examples/international_sales/data.parquet new file mode 100644 index 00000000000..952a2ed9b52 Binary files /dev/null and b/superset/examples/international_sales/data.parquet differ diff --git a/superset/examples/international_sales/dataset.yaml b/superset/examples/international_sales/dataset.yaml new file mode 100644 index 00000000000..3c498a6a4ef --- /dev/null +++ b/superset/examples/international_sales/dataset.yaml @@ -0,0 +1,241 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +always_filter_main_dttm: false +cache_timeout: null +catalog: null +columns: +- advanced_data_type: null + column_name: id + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: INTEGER + verbose_name: null +- advanced_data_type: null + column_name: transaction_date + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: true + python_date_format: null + type: DATE + verbose_name: null +- advanced_data_type: null + column_name: region + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR(50) + verbose_name: null +- advanced_data_type: null + column_name: country + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR(50) + verbose_name: null +- advanced_data_type: null + column_name: product_category + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR(50) + verbose_name: null +- advanced_data_type: null + column_name: product_name + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR(100) + verbose_name: null +- advanced_data_type: null + column_name: quantity + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: INTEGER + verbose_name: null +- advanced_data_type: null + column_name: unit_price + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: NUMERIC(12,2) + verbose_name: null +- advanced_data_type: null + column_name: revenue + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: NUMERIC(14,2) + verbose_name: null +- advanced_data_type: null + column_name: cost + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: NUMERIC(14,2) + verbose_name: null +- advanced_data_type: null + column_name: profit + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: NUMERIC(14,2) + verbose_name: null +- advanced_data_type: null + column_name: currency_code + description: Currency code for dynamic formatting (USD, EUR, GBP, JPY, CAD, AUD) + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR(10) + verbose_name: Currency Code +- advanced_data_type: null + column_name: currency_symbol + description: Currency symbol for display + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR(10) + verbose_name: Currency Symbol +data_file: data.parquet +database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee +default_endpoint: null +description: International sales transactions across multiple currencies for demonstrating dynamic currency formatting features. +extra: + currency_code_column: currency_code +fetch_values_predicate: null +filter_select_enabled: true +folders: null +main_dttm_col: transaction_date +metrics: +- currency: null + d3format: null + description: null + expression: COUNT(*) + extra: null + metric_name: count + metric_type: count + verbose_name: COUNT(*) + warning_text: null +- currency: null + d3format: ',.2f' + description: Total revenue + expression: SUM(revenue) + extra: null + metric_name: sum_revenue + metric_type: null + verbose_name: Total Revenue + warning_text: null +- currency: null + d3format: ',.2f' + description: Total profit + expression: SUM(profit) + extra: null + metric_name: sum_profit + metric_type: null + verbose_name: Total Profit + warning_text: null +- currency: null + d3format: ',.2f' + description: Total cost + expression: SUM(cost) + extra: null + metric_name: sum_cost + metric_type: null + verbose_name: Total Cost + warning_text: null +- currency: null + d3format: null + description: Total quantity sold + expression: SUM(quantity) + extra: null + metric_name: sum_quantity + metric_type: null + verbose_name: Total Quantity + warning_text: null +normalize_columns: false +offset: 0 +params: null +schema: null +sql: null +table_name: international_sales +template_params: null +uuid: e4b5c6d7-8f9a-0b1c-2d3e-4f5a6b7c8d9e +version: 1.0.0 diff --git a/superset/examples/long_lat.py b/superset/examples/long_lat.py deleted file mode 100644 index c201535ea45..00000000000 --- a/superset/examples/long_lat.py +++ /dev/null @@ -1,127 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -import datetime -import logging -import random - -import geohash -from sqlalchemy import DateTime, Float, inspect, String - -import superset.utils.database as database_utils -from superset import db -from superset.models.slice import Slice -from superset.sql.parse import Table -from superset.utils.core import DatasourceType - -from .helpers import ( - get_slice_json, - get_table_connector_registry, - merge_slice, - misc_dash_slices, - read_example_data, -) - -logger = logging.getLogger(__name__) - - -def load_long_lat_data(only_metadata: bool = False, force: bool = False) -> None: - """Loading lat/long data from a csv file in the repo""" - tbl_name = "long_lat" - database = database_utils.get_example_database() - with database.get_sqla_engine() as engine: - schema = inspect(engine).default_schema_name - table_exists = database.has_table(Table(tbl_name, schema)) - - if not only_metadata and (not table_exists or force): - pdf = read_example_data( - "examples://san_francisco.csv.gz", encoding="utf-8", compression="gzip" - ) - start = datetime.datetime.now().replace( - hour=0, minute=0, second=0, microsecond=0 - ) - pdf["datetime"] = [ - start + datetime.timedelta(hours=i * 24 / (len(pdf) - 1)) - for i in range(len(pdf)) - ] - pdf["occupancy"] = [random.randint(1, 6) for _ in range(len(pdf))] # noqa: S311 - pdf["radius_miles"] = [random.uniform(1, 3) for _ in range(len(pdf))] # noqa: S311 - pdf["geohash"] = pdf[["LAT", "LON"]].apply( - lambda x: geohash.encode(*x), axis=1 - ) - pdf["delimited"] = pdf["LAT"].map(str).str.cat(pdf["LON"].map(str), sep=",") - pdf.to_sql( - tbl_name, - engine, - schema=schema, - if_exists="replace", - chunksize=500, - dtype={ - "longitude": Float(), - "latitude": Float(), - "number": Float(), - "street": String(100), - "unit": String(10), - "city": String(50), - "district": String(50), - "region": String(50), - "postcode": Float(), - "id": String(100), - "datetime": DateTime(), - "occupancy": Float(), - "radius_miles": Float(), - "geohash": String(12), - "delimited": String(60), - }, - index=False, - ) - logger.debug("Done loading table!") - logger.debug("-" * 80) - - logger.debug("Creating table reference") - table = get_table_connector_registry() - obj = db.session.query(table).filter_by(table_name=tbl_name).first() - if not obj: - obj = table(table_name=tbl_name, schema=schema) - db.session.add(obj) - obj.main_dttm_col = "datetime" - obj.database = database - obj.filter_select_enabled = True - obj.fetch_metadata() - tbl = obj - - slice_data = { - "granularity_sqla": "day", - "since": "2014-01-01", - "until": "now", - "viz_type": "mapbox", - "all_columns_x": "LON", - "all_columns_y": "LAT", - "mapbox_style": "https://tile.openstreetmap.org/{z}/{x}/{y}.png", - "all_columns": ["occupancy"], - "row_limit": 500000, - } - - logger.debug("Creating a slice") - slc = Slice( - slice_name="OSM Long/Lat", - viz_type="osm", - datasource_type=DatasourceType.TABLE, - datasource_id=tbl.id, - params=get_slice_json(slice_data), - ) - misc_dash_slices.add(slc.slice_name) - merge_slice(slc) diff --git a/superset/examples/misc_charts/charts/Birth_in_France_by_department_in_2016.yaml b/superset/examples/misc_charts/charts/Birth_in_France_by_department_in_2016.yaml new file mode 100644 index 00000000000..51180d3fdb7 --- /dev/null +++ b/superset/examples/misc_charts/charts/Birth_in_France_by_department_in_2016.yaml @@ -0,0 +1,42 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 6ee06b3e-eccf-4c3d-9cc6-2955e4cb9a62 +description: null +params: + entity: DEPT_ID + granularity_sqla: '' + metric: + aggregate: AVG + column: + column_name: '2004' + type: INT + expressionType: SIMPLE + label: Boys + optionName: metric_112342 + row_limit: 500000 + select_country: france + since: '' + until: '' + viz_type: country_map +query_context: null +slice_name: Birth in France by department in 2016 +uuid: fe23db78-c168-4ce2-86b0-38d82bb37d88 +version: 1.0.0 +viz_type: country_map diff --git a/superset/examples/misc_charts/charts/Parallel_Coordinates.yaml b/superset/examples/misc_charts/charts/Parallel_Coordinates.yaml new file mode 100644 index 00000000000..fbb1805ea19 --- /dev/null +++ b/superset/examples/misc_charts/charts/Parallel_Coordinates.yaml @@ -0,0 +1,47 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 69e9de42-fe7f-4948-946a-f7913227aee8 +description: null +params: + compare_lag: '10' + compare_suffix: o10Y + country_fieldtype: cca3 + entity: country_code + granularity_sqla: year + groupby: [] + limit: 100 + markup_type: markdown + metrics: + - sum__SP_POP_TOTL + - sum__SP_RUR_TOTL_ZS + - sum__SH_DYN_AIDS + row_limit: 50000 + secondary_metric: sum__SP_POP_TOTL + series: country_name + show_bubbles: true + since: '2011-01-01' + time_range: '2014-01-01 : 2014-01-02' + until: '2012-01-01' + viz_type: para +query_context: null +slice_name: Parallel Coordinates +uuid: 48bf196c-f5fe-4e6c-b8ed-166e36b6648b +version: 1.0.0 +viz_type: para diff --git a/superset/examples/misc_charts/charts/Unicode_Cloud.yaml b/superset/examples/misc_charts/charts/Unicode_Cloud.yaml new file mode 100644 index 00000000000..6a7404c8b19 --- /dev/null +++ b/superset/examples/misc_charts/charts/Unicode_Cloud.yaml @@ -0,0 +1,69 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: a6771c73-96fc-44c6-8b6e-9d303955ea48 +description: null +params: + adhoc_filters: + - clause: WHERE + comparator: '100 years ago : now' + expressionType: SIMPLE + operator: TEMPORAL_RANGE + subject: dttm + dashboards: + - 3 + datasource: 21__table + extra_form_data: {} + matrixify_charts_per_row: 4 + matrixify_dimension_columns: + dimension: '' + values: [] + matrixify_dimension_rows: + dimension: '' + values: [] + matrixify_dimension_selection_mode_columns: members + matrixify_dimension_selection_mode_rows: members + matrixify_fit_columns_dynamically: true + matrixify_mode_columns: metrics + matrixify_mode_rows: metrics + matrixify_row_height: 300 + matrixify_show_column_headers: true + matrixify_show_row_labels: true + matrixify_topn_order_columns: desc + matrixify_topn_order_rows: desc + matrixify_topn_value_columns: 10 + matrixify_topn_value_rows: 10 + metric: + aggregate: SUM + column: + column_name: value + expressionType: SIMPLE + label: Value + rotation: square + row_limit: 50000 + series: short_phrase + size_from: '10' + size_to: '70' + slice_id: 66 + viz_type: word_cloud +query_context: null +slice_name: Unicode Cloud +uuid: ed3032d8-7961-4576-8fc4-2a61639a38bf +version: 1.0.0 +viz_type: word_cloud diff --git a/superset/examples/misc_charts/dashboard.yaml b/superset/examples/misc_charts/dashboard.yaml new file mode 100644 index 00000000000..a0fc727f188 --- /dev/null +++ b/superset/examples/misc_charts/dashboard.yaml @@ -0,0 +1,161 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +certification_details: '' +certified_by: '' +css: '' +dashboard_title: Misc Charts +description: null +metadata: + chart_configuration: {} + color_scheme: '' + color_scheme_domain: [] + cross_filters_enabled: true + default_filters: '{}' + expanded_slices: {} + global_chart_configuration: + chartsInScope: + - 48bf196c-f5fe-4e6c-b8ed-166e36b6648b + - fe23db78-c168-4ce2-86b0-38d82bb37d88 + - ed3032d8-7961-4576-8fc4-2a61639a38bf + scope: + excluded: [] + rootPath: + - ROOT_ID + label_colors: {} + map_label_colors: + A ligeira: '#EFA1AA' + A rápida r: '#FF7F44' + Agera vulp: '#A38F79' + Egy hűtlen: '#A38F79' + El veloz m: '#9EE5E5' + En god sti: '#454E7C' + Eĥoŝanĝo ĉ: '#666666' + Flygande b: '#A1A6BD' + Franz jagt: '#D1C6BC' + Kŕdeľ šťas: '#8FD3E4' + Ma la volp: '#FCC700' + Pa’s wijze: '#ACE1C4' + Pchnąć w t: '#ACE1C4' + Pijamalı h: '#FEC0A1' + Portez ce: '#EFA1AA' + Příliš žlu: '#FF7F44' + Quizdeltag: '#454E7C' + Sarkanās j: '#454E7C' + Saya lihat: '#E04355' + See väike: '#A1A6BD' + V kožuščku: '#E04355' + Viekas ket: '#FDE380' + Voix ambig: '#666666' + Zebras cao: '#D3B3DA' + Zwölf Boxk: '#B2B2B2' + Árvíztűrő: '#B2B2B2' + Češće ceđe: '#FCC700' + Θέλει αρετ: '#D3B3DA' + Ο καλύμνιο: '#8FD3E4' + Под южно д: '#1FA8C9' + Съешь ещё: '#3CCCCB' + Чешће цeђе: '#D1C6BC' + דג סקרן שט: '#D1C6BC' + ئاۋۇ بىر ج: '#5AC189' + زۆھرەگۈل ئ: '#A868B7' + เป็นมนุษย์: '#FDE380' + いろはにほへと ちり: '#A868B7' + 中国智造，慧及全球: '#FEC0A1' + 微風迎客，軟語伴茶: '#9EE5E5' + 視野無限廣，窗外有藍: '#5AC189' + 다람쥐 헌 쳇바퀴에: '#3CCCCB' + native_filter_configuration: [] + refresh_frequency: 0 + shared_label_colors: [] + timed_refresh_immune_slices: [] +position: + CHART-S1WYNz4AVX: + children: [] + id: CHART-S1WYNz4AVX + meta: + chartId: 131 + height: 69 + sliceName: Parallel Coordinates + uuid: 48bf196c-f5fe-4e6c-b8ed-166e36b6648b + width: 4 + parents: + - ROOT_ID + - GRID_ID + - ROW-SytNzNA4X + type: CHART + CHART-explore-160-1: + children: [] + id: CHART-explore-160-1 + meta: + chartId: 160 + height: 69 + sliceName: Unicode Cloud + uuid: ed3032d8-7961-4576-8fc4-2a61639a38bf + width: 4 + parents: + - ROOT_ID + - GRID_ID + - ROW-jcftwdQAVlnpQ5SkYkA2K + type: CHART + CHART-rkgF4G4A4X: + children: [] + id: CHART-rkgF4G4A4X + meta: + chartId: 152 + height: 69 + sliceName: Birth in France by department in 2016 + uuid: fe23db78-c168-4ce2-86b0-38d82bb37d88 + width: 4 + parents: + - ROOT_ID + - GRID_ID + - ROW-SytNzNA4X + type: CHART + DASHBOARD_VERSION_KEY: v2 + GRID_ID: + children: + - ROW-SytNzNA4X + id: GRID_ID + parents: + - ROOT_ID + type: GRID + HEADER_ID: + id: HEADER_ID + meta: + text: Misc Charts + type: HEADER + ROOT_ID: + children: + - GRID_ID + id: ROOT_ID + type: ROOT + ROW-SytNzNA4X: + children: + - CHART-rkgF4G4A4X + - CHART-S1WYNz4AVX + - CHART-explore-160-1 + id: ROW-SytNzNA4X + meta: + background: BACKGROUND_TRANSPARENT + parents: + - ROOT_ID + - GRID_ID + type: ROW +published: false +slug: misc_charts +uuid: b388a396-cbca-4299-a443-3e41e870e2c2 +version: 1.0.0 diff --git a/superset/examples/misc_charts/data/birth_france_by_region.parquet b/superset/examples/misc_charts/data/birth_france_by_region.parquet new file mode 100644 index 00000000000..8fe6b4bb0db Binary files /dev/null and b/superset/examples/misc_charts/data/birth_france_by_region.parquet differ diff --git a/superset/examples/misc_charts/data/unicode_test.parquet b/superset/examples/misc_charts/data/unicode_test.parquet new file mode 100644 index 00000000000..3b8bdac221e Binary files /dev/null and b/superset/examples/misc_charts/data/unicode_test.parquet differ diff --git a/superset/examples/misc_charts/data/wb_health_population.parquet b/superset/examples/misc_charts/data/wb_health_population.parquet new file mode 100644 index 00000000000..3b49720bac0 Binary files /dev/null and b/superset/examples/misc_charts/data/wb_health_population.parquet differ diff --git a/superset/examples/misc_charts/datasets/birth_france_by_region.yaml b/superset/examples/misc_charts/datasets/birth_france_by_region.yaml new file mode 100644 index 00000000000..72ac2dcc84c --- /dev/null +++ b/superset/examples/misc_charts/datasets/birth_france_by_region.yaml @@ -0,0 +1,225 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +always_filter_main_dttm: false +cache_timeout: null +catalog: null +columns: +- advanced_data_type: null + column_name: DEPT_ID + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: '2003' + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: '2004' + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: '2005' + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: '2006' + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: '2007' + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: '2008' + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: '2009' + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: '2010' + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: '2011' + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: '2012' + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: '2013' + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: '2014' + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: dttm + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: true + python_date_format: null + type: DATE + verbose_name: null +data_file: birth_france_by_region.parquet +database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee +default_endpoint: null +description: null +extra: null +fetch_values_predicate: null +filter_select_enabled: true +folders: null +main_dttm_col: dttm +metrics: +- currency: null + d3format: null + description: null + expression: AVG("2004") + extra: null + metric_name: avg__2004 + metric_type: null + verbose_name: null + warning_text: null +- currency: null + d3format: null + description: null + expression: COUNT(*) + extra: null + metric_name: count + metric_type: count + verbose_name: COUNT(*) + warning_text: null +normalize_columns: false +offset: 0 +params: null +schema: null +sql: null +table_name: birth_france_by_region +template_params: null +uuid: 6ee06b3e-eccf-4c3d-9cc6-2955e4cb9a62 +version: 1.0.0 diff --git a/superset/examples/configs/datasets/examples/unicode_test.test.yaml b/superset/examples/misc_charts/datasets/unicode_test.yaml similarity index 81% rename from superset/examples/configs/datasets/examples/unicode_test.test.yaml rename to superset/examples/misc_charts/datasets/unicode_test.yaml index 66968532a5d..dba39f3d4c1 100644 --- a/superset/examples/configs/datasets/examples/unicode_test.test.yaml +++ b/superset/examples/misc_charts/datasets/unicode_test.yaml @@ -14,80 +14,95 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -table_name: unicode_test -main_dttm_col: dttm -description: null -default_endpoint: null -offset: 0 +always_filter_main_dttm: false cache_timeout: null +catalog: null +columns: +- advanced_data_type: null + column_name: with_missing + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR(100) + verbose_name: null +- advanced_data_type: null + column_name: phrase + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR(500) + verbose_name: null +- advanced_data_type: null + column_name: short_phrase + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR(10) + verbose_name: null +- advanced_data_type: null + column_name: dttm + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: true + python_date_format: null + type: DATE + verbose_name: null +- advanced_data_type: null + column_name: value + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +data_file: unicode_test.parquet +database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee +default_endpoint: null +description: null +extra: null +fetch_values_predicate: null +filter_select_enabled: true +folders: null +main_dttm_col: dttm +metrics: +- currency: null + d3format: null + description: null + expression: COUNT(*) + extra: null + metric_name: count + metric_type: count + verbose_name: COUNT(*) + warning_text: null +normalize_columns: false +offset: 0 +params: null schema: null sql: null -params: null +table_name: unicode_test template_params: null -filter_select_enabled: true -fetch_values_predicate: null -extra: null uuid: a6771c73-96fc-44c6-8b6e-9d303955ea48 -metrics: -- metric_name: count - verbose_name: COUNT(*) - metric_type: count - expression: COUNT(*) - description: null - d3format: null - extra: null - warning_text: null -columns: -- column_name: with_missing - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR(100) - groupby: true - filterable: true - expression: '' - description: null - python_date_format: null -- column_name: phrase - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR(500) - groupby: true - filterable: true - expression: '' - description: null - python_date_format: null -- column_name: short_phrase - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR(10) - groupby: true - filterable: true - expression: '' - description: null - python_date_format: null -- column_name: dttm - verbose_name: null - is_dttm: true - is_active: true - type: DATE - groupby: true - filterable: true - expression: '' - description: null - python_date_format: null -- column_name: value - verbose_name: null - is_dttm: false - is_active: true - type: FLOAT - groupby: true - filterable: true - expression: '' - description: null - python_date_format: null version: 1.0.0 -database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee -data: examples://datasets/examples/unicode_test.csv diff --git a/superset/examples/misc_charts/datasets/wb_health_population.yaml b/superset/examples/misc_charts/datasets/wb_health_population.yaml new file mode 100644 index 00000000000..e01a8732e9f --- /dev/null +++ b/superset/examples/misc_charts/datasets/wb_health_population.yaml @@ -0,0 +1,4319 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +always_filter_main_dttm: false +cache_timeout: null +catalog: null +columns: +- advanced_data_type: null + column_name: country_name + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: country_code + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: region + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: year + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: true + python_date_format: null + type: TIMESTAMP WITHOUT TIME ZONE + verbose_name: null +- advanced_data_type: null + column_name: NY_GNP_PCAP_CD + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_ADT_1524_LT_FM_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_ADT_1524_LT_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_ADT_1524_LT_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_ADT_LITR_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_ADT_LITR_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_ADT_LITR_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_ENR_ORPH + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_PRM_CMPT_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_PRM_CMPT_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_PRM_CMPT_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_PRM_ENRR + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_PRM_ENRR_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_PRM_ENRR_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_PRM_NENR + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_PRM_NENR_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_PRM_NENR_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_SEC_ENRR + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_SEC_ENRR_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_SEC_ENRR_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_SEC_NENR + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_SEC_NENR_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_SEC_NENR_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_TER_ENRR + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_TER_ENRR_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_XPD_TOTL_GD_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_ANM_CHLD_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_ANM_NPRG_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_CON_1524_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_CON_1524_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_CON_AIDS_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_CON_AIDS_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_DTH_COMM_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_DTH_IMRT + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_DTH_INJR_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_DTH_MORT + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_DTH_NCOM_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_DTH_NMRT + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_DYN_AIDS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_DYN_AIDS_DH + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_DYN_AIDS_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_DYN_AIDS_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_DYN_MORT + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_DYN_MORT_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_DYN_MORT_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_DYN_NMRT + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_FPL_SATI_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_H2O_SAFE_RU_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_H2O_SAFE_UR_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_H2O_SAFE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_HIV_0014 + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_HIV_1524_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_HIV_1524_KW_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_HIV_1524_KW_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_HIV_1524_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_HIV_ARTC_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_HIV_KNOW_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_HIV_KNOW_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_HIV_ORPH + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_HIV_TOTL + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_IMM_HEPB + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_IMM_HIB3 + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_IMM_IBCG + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_IMM_IDPT + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_IMM_MEAS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_IMM_POL3 + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_MED_BEDS_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_MED_CMHW_P3 + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_MED_NUMW_P3 + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_MED_PHYS_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_MLR_NETS_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_MLR_PREG_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_MLR_SPF2_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_MLR_TRET_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_MMR_DTHS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_MMR_LEVE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_MMR_RISK + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_MMR_RISK_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_MMR_WAGE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_PRG_ANEM + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_PRG_ARTC_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_PRG_SYPH_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_PRV_SMOK_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_PRV_SMOK_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_ACSN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_ACSN_RU + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_ACSN_UR + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_ANV4_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_ANVC_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_ARIC_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_BFED_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_BRTC_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_BRTW_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_DIAB_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_IYCF_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_MALN_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_MALN_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_MALN_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_MALR + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_MMRT + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_MMRT_NE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_ORCF_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_ORTH + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_OW15_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_OW15_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_OW15_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_OWGH_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_OWGH_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_OWGH_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_PNVC_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_STNT_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_STNT_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_STNT_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_WAST_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_WAST_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_WAST_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_SVR_WAST_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_SVR_WAST_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_SVR_WAST_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_TBS_CURE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_TBS_DTEC_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_TBS_INCD + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_TBS_MORT + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_TBS_PREV + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_VAC_TTNS_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_XPD_EXTR_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_XPD_OOPC_TO_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_XPD_OOPC_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_XPD_PCAP + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_XPD_PCAP_PP_KD + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_XPD_PRIV + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_XPD_PRIV_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_XPD_PUBL + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_XPD_PUBL_GX_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_XPD_PUBL_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_XPD_TOTL_CD + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_XPD_TOTL_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SI_POV_NAHC + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SI_POV_RUHC + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SI_POV_URHC + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SL_EMP_INSV_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SL_TLF_TOTL_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SL_TLF_TOTL_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SL_UEM_TOTL_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SL_UEM_TOTL_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SL_UEM_TOTL_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SM_POP_NETM + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SN_ITK_DEFC + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SN_ITK_DEFC_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SN_ITK_SALT_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SN_ITK_VITA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_ADO_TFRT + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_AMRT_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_AMRT_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_CBRT_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_CDRT_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_CONU_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_IMRT_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_IMRT_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_IMRT_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_LE00_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_LE00_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_LE00_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_SMAM_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_SMAM_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_TFRT_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_TO65_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_TO65_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_WFRT + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_HOU_FEMA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_MTR_1519_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_0004_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_0004_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_0004_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_0004_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_0014_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_0014_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_0014_TO + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_0014_TO_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_0509_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_0509_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_0509_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_0509_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_1014_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_1014_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_1014_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_1014_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_1519_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_1519_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_1519_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_1519_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_1564_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_1564_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_1564_TO + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_1564_TO_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_2024_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_2024_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_2024_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_2024_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_2529_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_2529_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_2529_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_2529_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_3034_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_3034_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_3034_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_3034_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_3539_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_3539_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_3539_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_3539_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_4044_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_4044_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_4044_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_4044_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_4549_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_4549_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_4549_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_4549_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_5054_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_5054_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_5054_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_5054_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_5559_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_5559_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_5559_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_5559_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_6064_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_6064_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_6064_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_6064_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_6569_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_6569_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_6569_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_6569_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_65UP_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_65UP_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_65UP_TO + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_65UP_TO_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_7074_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_7074_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_7074_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_7074_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_7579_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_7579_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_7579_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_7579_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_80UP_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_80UP_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_80UP_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_80UP_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG00_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG00_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG01_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG01_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG02_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG02_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG03_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG03_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG04_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG04_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG05_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG05_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG06_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG06_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG07_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG07_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG08_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG08_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG09_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG09_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG10_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG10_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG11_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG11_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG12_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG12_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG13_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG13_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG14_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG14_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG15_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG15_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG16_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG16_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG17_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG17_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG18_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG18_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG19_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG19_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG20_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG20_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG21_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG21_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG22_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG22_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG23_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG23_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG24_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG24_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG25_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG25_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_BRTH_MF + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_DPND + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_DPND_OL + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_DPND_YG + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_GROW + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_TOTL + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_TOTL_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_TOTL_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_TOTL_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_TOTL_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_REG_BRTH_RU_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_REG_BRTH_UR_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_REG_BRTH_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_REG_DTHS_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_RUR_TOTL + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_RUR_TOTL_ZG + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_RUR_TOTL_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_URB_GROW + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_URB_TOTL + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_URB_TOTL_IN_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_UWT_TFRT + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +data_file: wb_health_population.parquet +database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee +default_endpoint: null +description: "\nThis data was\ + \ downloaded from the\n[World's Health Organization's website](https://datacatalog.worldbank.org/dataset/health-nutrition-and-population-statistics)\n\ + \nHere's the script that was used to massage the data:\n\n DIR = \"\"\n df_country\ + \ = pd.read_csv(DIR + '/HNP_Country.csv')\n df_country.columns = ['country_code']\ + \ + list(df_country.columns[1:])\n df_country = df_country[['country_code', 'Region']]\n\ + \ df_country.columns = ['country_code', 'region']\n\n df = pd.read_csv(DIR\ + \ + '/HNP_Data.csv')\n del df['Unnamed: 60']\n df.columns = ['country_name',\ + \ 'country_code'] + list(df.columns[2:])\n ndf = df.merge(df_country, how='inner')\n\ + \n dims = ('country_name', 'country_code', 'region')\n vv = [str(i) for i\ + \ in range(1960, 2015)]\n mdf = pd.melt(ndf, id_vars=dims + ('Indicator Code',),\ + \ value_vars=vv)\n mdf['year'] = mdf.variable + '-01-01'\n dims = dims + ('year',)\n\ + \n pdf = mdf.pivot_table(values='value', columns='Indicator Code', index=dims)\n\ + \ pdf = pdf.reset_index()\n pdf.to_csv(DIR + '/countries.csv')\n pdf.to_json(DIR\ + \ + '/countries.json', orient='records')\n\nHere's the description of the metrics\ + \ available:\n\nSeries | Code Indicator Name\n--- | ---\nNY.GNP.PCAP.CD | GNI per\ + \ capita, Atlas method (current US$)\nSE.ADT.1524.LT.FM.ZS | Literacy rate, youth\ + \ (ages 15-24), gender parity index (GPI)\nSE.ADT.1524.LT.MA.ZS | Literacy rate,\ + \ youth male (% of males ages 15-24)\nSE.ADT.1524.LT.ZS | Literacy rate, youth total\ + \ (% of people ages 15-24)\nSE.ADT.LITR.FE.ZS | Literacy rate, adult female (% of\ + \ females ages 15 and above)\nSE.ADT.LITR.MA.ZS | Literacy rate, adult male (% of\ + \ males ages 15 and above)\nSE.ADT.LITR.ZS | Literacy rate, adult total (% of people\ + \ ages 15 and above)\nSE.ENR.ORPH | Ratio of school attendance of orphans to school\ + \ attendance of non-orphans ages 10-14\nSE.PRM.CMPT.FE.ZS | Primary completion rate,\ + \ female (% of relevant age group)\nSE.PRM.CMPT.MA.ZS | Primary completion rate,\ + \ male (% of relevant age group)\nSE.PRM.CMPT.ZS | Primary completion rate, total\ + \ (% of relevant age group)\nSE.PRM.ENRR | School enrollment, primary (% gross)\n\ + SE.PRM.ENRR.FE | School enrollment, primary, female (% gross)\nSE.PRM.ENRR.MA |\ + \ School enrollment, primary, male (% gross)\nSE.PRM.NENR | School enrollment, primary\ + \ (% net)\nSE.PRM.NENR.FE | School enrollment, primary, female (% net)\nSE.PRM.NENR.MA\ + \ | School enrollment, primary, male (% net)\nSE.SEC.ENRR | School enrollment, secondary\ + \ (% gross)\nSE.SEC.ENRR.FE | School enrollment, secondary, female (% gross)\nSE.SEC.ENRR.MA\ + \ | School enrollment, secondary, male (% gross)\nSE.SEC.NENR | School enrollment,\ + \ secondary (% net)\nSE.SEC.NENR.FE | School enrollment, secondary, female (% net)\n\ + SE.SEC.NENR.MA | School enrollment, secondary, male (% net)\nSE.TER.ENRR | School\ + \ enrollment, tertiary (% gross)\nSE.TER.ENRR.FE | School enrollment, tertiary,\ + \ female (% gross)\nSE.XPD.TOTL.GD.ZS | Government expenditure on education, total\ + \ (% of GDP)\nSH.ANM.CHLD.ZS | Prevalence of anemia among children (% of children\ + \ under 5)\nSH.ANM.NPRG.ZS | Prevalence of anemia among non-pregnant women (% of\ + \ women ages 15-49)\nSH.CON.1524.FE.ZS | Condom use, population ages 15-24, female\ + \ (% of females ages 15-24)\nSH.CON.1524.MA.ZS | Condom use, population ages 15-24,\ + \ male (% of males ages 15-24)\nSH.CON.AIDS.FE.ZS | Condom use at last high-risk\ + \ sex, adult female (% ages 15-49)\nSH.CON.AIDS.MA.ZS | Condom use at last high-risk\ + \ sex, adult male (% ages 15-49)\nSH.DTH.COMM.ZS | Cause of death, by communicable\ + \ diseases and maternal, prenatal and nutrition conditions (% of total)\nSH.DTH.IMRT\ + \ | Number of infant deaths\nSH.DTH.INJR.ZS | Cause of death, by injury (% of total)\n\ + SH.DTH.MORT | Number of under-five deaths\nSH.DTH.NCOM.ZS | Cause of death, by non-communicable\ + \ diseases (% of total)\nSH.DTH.NMRT | Number of neonatal deaths\nSH.DYN.AIDS |\ + \ Adults (ages 15+) living with HIV\nSH.DYN.AIDS.DH | AIDS estimated deaths (UNAIDS\ + \ estimates)\nSH.DYN.AIDS.FE.ZS | Women's share of population ages 15+ living with\ + \ HIV (%)\nSH.DYN.AIDS.ZS | Prevalence of HIV, total (% of population ages 15-49)\n\ + SH.DYN.MORT | Mortality rate, under-5 (per 1,000 live births)\nSH.DYN.MORT.FE |\ + \ Mortality rate, under-5, female (per 1,000 live births)\nSH.DYN.MORT.MA | Mortality\ + \ rate, under-5, male (per 1,000 live births)\nSH.DYN.NMRT | Mortality rate, neonatal\ + \ (per 1,000 live births)\nSH.FPL.SATI.ZS | Met need for contraception (% of married\ + \ women ages 15-49)\nSH.H2O.SAFE.RU.ZS | Improved water source, rural (% of rural\ + \ population with access)\nSH.H2O.SAFE.UR.ZS | Improved water source, urban (% of\ + \ urban population with access)\nSH.H2O.SAFE.ZS | Improved water source (% of population\ + \ with access)\nSH.HIV.0014 | Children (0-14) living with HIV\nSH.HIV.1524.FE.ZS\ + \ | Prevalence of HIV, female (% ages 15-24)\nSH.HIV.1524.KW.FE.ZS | Comprehensive\ + \ correct knowledge of HIV/AIDS, ages 15-24, female (2 prevent ways and reject 3\ + \ misconceptions)\nSH.HIV.1524.KW.MA.ZS | Comprehensive correct knowledge of HIV/AIDS,\ + \ ages 15-24, male (2 prevent ways and reject 3 misconceptions)\nSH.HIV.1524.MA.ZS\ + \ | Prevalence of HIV, male (% ages 15-24)\nSH.HIV.ARTC.ZS | Antiretroviral therapy\ + \ coverage (% of people living with HIV)\nSH.HIV.KNOW.FE.ZS | % of females ages\ + \ 15-49 having comprehensive correct knowledge about HIV (2 prevent ways and reject\ + \ 3 misconceptions)\nSH.HIV.KNOW.MA.ZS | % of males ages 15-49 having comprehensive\ + \ correct knowledge about HIV (2 prevent ways and reject 3 misconceptions)\nSH.HIV.ORPH\ + \ | Children orphaned by HIV/AIDS\nSH.HIV.TOTL | Adults (ages 15+) and children\ + \ (0-14 years) living with HIV\nSH.IMM.HEPB | Immunization, HepB3 (% of one-year-old\ + \ children)\nSH.IMM.HIB3 | Immunization, Hib3 (% of children ages 12-23 months)\n\ + SH.IMM.IBCG | Immunization, BCG (% of one-year-old children)\nSH.IMM.IDPT | Immunization,\ + \ DPT (% of children ages 12-23 months)\nSH.IMM.MEAS | Immunization, measles (%\ + \ of children ages 12-23 months)\nSH.IMM.POL3 | Immunization, Pol3 (% of one-year-old\ + \ children)\nSH.MED.BEDS.ZS | Hospital beds (per 1,000 people)\nSH.MED.CMHW.P3 |\ + \ Community health workers (per 1,000 people)\nSH.MED.NUMW.P3 | Nurses and midwives\ + \ (per 1,000 people)\nSH.MED.PHYS.ZS | Physicians (per 1,000 people)\nSH.MLR.NETS.ZS\ + \ | Use of insecticide-treated bed nets (% of under-5 population)\nSH.MLR.PREG.ZS\ + \ | Use of any antimalarial drug (% of pregnant women)\nSH.MLR.SPF2.ZS | Use of\ + \ Intermittent Preventive Treatment of malaria, 2+ doses of SP/Fansidar (% of pregnant\ + \ women)\nSH.MLR.TRET.ZS | Children with fever receiving antimalarial drugs (% of\ + \ children under age 5 with fever)\nSH.MMR.DTHS | Number of maternal deaths\nSH.MMR.LEVE\ + \ | Number of weeks of maternity leave\nSH.MMR.RISK | Lifetime risk of maternal\ + \ death (1 in: rate varies by country)\nSH.MMR.RISK.ZS | Lifetime risk of maternal\ + \ death (%)\nSH.MMR.WAGE.ZS | Maternal leave benefits (% of wages paid in covered\ + \ period)\nSH.PRG.ANEM | Prevalence of anemia among pregnant women (%)\nSH.PRG.ARTC.ZS\ + \ | Antiretroviral therapy coverage (% of pregnant women living with HIV)\nSH.PRG.SYPH.ZS\ + \ | Prevalence of syphilis (% of women attending antenatal care)\nSH.PRV.SMOK.FE\ + \ | Smoking prevalence, females (% of adults)\nSH.PRV.SMOK.MA | Smoking prevalence,\ + \ males (% of adults)\nSH.STA.ACSN | Improved sanitation facilities (% of population\ + \ with access)\nSH.STA.ACSN.RU | Improved sanitation facilities, rural (% of rural\ + \ population with access)\nSH.STA.ACSN.UR | Improved sanitation facilities, urban\ + \ (% of urban population with access)\nSH.STA.ANV4.ZS | Pregnant women receiving\ + \ prenatal care of at least four visits (% of pregnant women)\nSH.STA.ANVC.ZS |\ + \ Pregnant women receiving prenatal care (%)\nSH.STA.ARIC.ZS | ARI treatment (%\ + \ of children under 5 taken to a health provider)\nSH.STA.BFED.ZS | Exclusive breastfeeding\ + \ (% of children under 6 months)\nSH.STA.BRTC.ZS | Births attended by skilled health\ + \ staff (% of total)\nSH.STA.BRTW.ZS | Low-birthweight babies (% of births)\nSH.STA.DIAB.ZS\ + \ | Diabetes prevalence (% of population ages 20 to 79)\nSH.STA.IYCF.ZS | Infant\ + \ and young child feeding practices, all 3 IYCF (% children ages 6-23 months)\n\ + SH.STA.MALN.FE.ZS | Prevalence of underweight, weight for age, female (% of children\ + \ under 5)\nSH.STA.MALN.MA.ZS | Prevalence of underweight, weight for age, male\ + \ (% of children under 5)\nSH.STA.MALN.ZS | Prevalence of underweight, weight for\ + \ age (% of children under 5)\nSH.STA.MALR | Malaria cases reported\nSH.STA.MMRT\ + \ | Maternal mortality ratio (modeled estimate, per 100,000 live births)\nSH.STA.MMRT.NE\ + \ | Maternal mortality ratio (national estimate, per 100,000 live births)\nSH.STA.ORCF.ZS\ + \ | Diarrhea treatment (% of children under 5 receiving oral rehydration and continued\ + \ feeding)\nSH.STA.ORTH | Diarrhea treatment (% of children under 5 who received\ + \ ORS packet)\nSH.STA.OW15.FE.ZS | Prevalence of overweight, female (% of female\ + \ adults)\nSH.STA.OW15.MA.ZS | Prevalence of overweight, male (% of male adults)\n\ + SH.STA.OW15.ZS | Prevalence of overweight (% of adults)\nSH.STA.OWGH.FE.ZS | Prevalence\ + \ of overweight, weight for height, female (% of children under 5)\nSH.STA.OWGH.MA.ZS\ + \ | Prevalence of overweight, weight for height, male (% of children under 5)\n\ + SH.STA.OWGH.ZS | Prevalence of overweight, weight for height (% of children under\ + \ 5)\nSH.STA.PNVC.ZS | Postnatal care coverage (% mothers)\nSH.STA.STNT.FE.ZS |\ + \ Prevalence of stunting, height for age, female (% of children under 5)\nSH.STA.STNT.MA.ZS\ + \ | Prevalence of stunting, height for age, male (% of children under 5)\nSH.STA.STNT.ZS\ + \ | Prevalence of stunting, height for age (% of children under 5)\nSH.STA.WAST.FE.ZS\ + \ | Prevalence of wasting, weight for height, female (% of children under 5)\nSH.STA.WAST.MA.ZS\ + \ | Prevalence of wasting, weight for height, male (% of children under 5)\nSH.STA.WAST.ZS\ + \ | Prevalence of wasting, weight for height (% of children under 5)\nSH.SVR.WAST.FE.ZS\ + \ | Prevalence of severe wasting, weight for height, female (% of children under\ + \ 5)\nSH.SVR.WAST.MA.ZS | Prevalence of severe wasting, weight for height, male\ + \ (% of children under 5)\nSH.SVR.WAST.ZS | Prevalence of severe wasting, weight\ + \ for height (% of children under 5)\nSH.TBS.CURE.ZS | Tuberculosis treatment success\ + \ rate (% of new cases)\nSH.TBS.DTEC.ZS | Tuberculosis case detection rate (%, all\ + \ forms)\nSH.TBS.INCD | Incidence of tuberculosis (per 100,000 people)\nSH.TBS.MORT\ + \ | Tuberculosis death rate (per 100,000 people)\nSH.TBS.PREV | Prevalence of tuberculosis\ + \ (per 100,000 population)\nSH.VAC.TTNS.ZS | Newborns protected against tetanus\ + \ (%)\nSH.XPD.EXTR.ZS | External resources for health (% of total expenditure on\ + \ health)\nSH.XPD.OOPC.TO.ZS | Out-of-pocket health expenditure (% of total expenditure\ + \ on health)\nSH.XPD.OOPC.ZS | Out-of-pocket health expenditure (% of private expenditure\ + \ on health)\nSH.XPD.PCAP | Health expenditure per capita (current US$)\nSH.XPD.PCAP.PP.KD\ + \ | Health expenditure per capita, PPP (constant 2011 international $)\nSH.XPD.PRIV\ + \ | Health expenditure, private (% of total health expenditure)\nSH.XPD.PRIV.ZS\ + \ | Health expenditure, private (% of GDP)\nSH.XPD.PUBL | Health expenditure, public\ + \ (% of total health expenditure)\nSH.XPD.PUBL.GX.ZS | Health expenditure, public\ + \ (% of government expenditure)\nSH.XPD.PUBL.ZS | Health expenditure, public (%\ + \ of GDP)\nSH.XPD.TOTL.CD | Health expenditure, total (current US$)\nSH.XPD.TOTL.ZS\ + \ | Health expenditure, total (% of GDP)\nSI.POV.NAHC | Poverty headcount ratio\ + \ at national poverty lines (% of population)\nSI.POV.RUHC | Rural poverty headcount\ + \ ratio at national poverty lines (% of rural population)\nSI.POV.URHC | Urban poverty\ + \ headcount ratio at national poverty lines (% of urban population)\nSL.EMP.INSV.FE.ZS\ + \ | Share of women in wage employment in the nonagricultural sector (% of total\ + \ nonagricultural employment)\nSL.TLF.TOTL.FE.ZS | Labor force, female (% of total\ + \ labor force)\nSL.TLF.TOTL.IN | Labor force, total\nSL.UEM.TOTL.FE.ZS | Unemployment,\ + \ female (% of female labor force) (modeled ILO estimate)\nSL.UEM.TOTL.MA.ZS | Unemployment,\ + \ male (% of male labor force) (modeled ILO estimate)\nSL.UEM.TOTL.ZS | Unemployment,\ + \ total (% of total labor force) (modeled ILO estimate)\nSM.POP.NETM | Net migration\n\ + SN.ITK.DEFC | Number of people who are undernourished\nSN.ITK.DEFC.ZS | Prevalence\ + \ of undernourishment (% of population)\nSN.ITK.SALT.ZS | Consumption of iodized\ + \ salt (% of households)\nSN.ITK.VITA.ZS | Vitamin A supplementation coverage rate\ + \ (% of children ages 6-59 months)\nSP.ADO.TFRT | Adolescent fertility rate (births\ + \ per 1,000 women ages 15-19)\nSP.DYN.AMRT.FE | Mortality rate, adult, female (per\ + \ 1,000 female adults)\nSP.DYN.AMRT.MA | Mortality rate, adult, male (per 1,000\ + \ male adults)\nSP.DYN.CBRT.IN | Birth rate, crude (per 1,000 people)\nSP.DYN.CDRT.IN\ + \ | Death rate, crude (per 1,000 people)\nSP.DYN.CONU.ZS | Contraceptive prevalence\ + \ (% of women ages 15-49)\nSP.DYN.IMRT.FE.IN | Mortality rate, infant, female (per\ + \ 1,000 live births)\nSP.DYN.IMRT.IN | Mortality rate, infant (per 1,000 live births)\n\ + SP.DYN.IMRT.MA.IN | Mortality rate, infant, male (per 1,000 live births)\nSP.DYN.LE00.FE.IN\ + \ | Life expectancy at birth, female (years)\nSP.DYN.LE00.IN | Life expectancy at\ + \ birth, total (years)\nSP.DYN.LE00.MA.IN | Life expectancy at birth, male (years)\n\ + SP.DYN.SMAM.FE | Mean age at first marriage, female\nSP.DYN.SMAM.MA | Mean age at\ + \ first marriage, male\nSP.DYN.TFRT.IN | Fertility rate, total (births per woman)\n\ + SP.DYN.TO65.FE.ZS | Survival to age 65, female (% of cohort)\nSP.DYN.TO65.MA.ZS\ + \ | Survival to age 65, male (% of cohort)\nSP.DYN.WFRT | Wanted fertility rate\ + \ (births per woman)\nSP.HOU.FEMA.ZS | Female headed households (% of households\ + \ with a female head)\nSP.MTR.1519.ZS | Teenage mothers (% of women ages 15-19 who\ + \ have had children or are currently pregnant)\nSP.POP.0004.FE | Population ages\ + \ 0-4, female\nSP.POP.0004.FE.5Y | Population ages 0-4, female (% of female population)\n\ + SP.POP.0004.MA | Population ages 0-4, male\nSP.POP.0004.MA.5Y | Population ages\ + \ 0-4, male (% of male population)\nSP.POP.0014.FE.ZS | Population ages 0-14, female\ + \ (% of total)\nSP.POP.0014.MA.ZS | Population ages 0-14, male (% of total)\nSP.POP.0014.TO\ + \ | Population ages 0-14, total\nSP.POP.0014.TO.ZS | Population ages 0-14 (% of\ + \ total)\nSP.POP.0509.FE | Population ages 5-9, female\nSP.POP.0509.FE.5Y | Population\ + \ ages 5-9, female (% of female population)\nSP.POP.0509.MA | Population ages 5-9,\ + \ male\nSP.POP.0509.MA.5Y | Population ages 5-9, male (% of male population)\nSP.POP.1014.FE\ + \ | Population ages 10-14, female\nSP.POP.1014.FE.5Y | Population ages 10-14, female\ + \ (% of female population)\nSP.POP.1014.MA | Population ages 10-14, male\nSP.POP.1014.MA.5Y\ + \ | Population ages 10-14, male (% of male population)\nSP.POP.1519.FE | Population\ + \ ages 15-19, female\nSP.POP.1519.FE.5Y | Population ages 15-19, female (% of female\ + \ population)\nSP.POP.1519.MA | Population ages 15-19, male\nSP.POP.1519.MA.5Y |\ + \ Population ages 15-19, male (% of male population)\nSP.POP.1564.FE.ZS | Population\ + \ ages 15-64, female (% of total)\nSP.POP.1564.MA.ZS | Population ages 15-64, male\ + \ (% of total)\nSP.POP.1564.TO | Population ages 15-64, total\nSP.POP.1564.TO.ZS\ + \ | Population ages 15-64 (% of total)\nSP.POP.2024.FE | Population ages 20-24,\ + \ female\nSP.POP.2024.FE.5Y | Population ages 20-24, female (% of female population)\n\ + SP.POP.2024.MA | Population ages 20-24, male\nSP.POP.2024.MA.5Y | Population ages\ + \ 20-24, male (% of male population)\nSP.POP.2529.FE | Population ages 25-29, female\n\ + SP.POP.2529.FE.5Y | Population ages 25-29, female (% of female population)\nSP.POP.2529.MA\ + \ | Population ages 25-29, male\nSP.POP.2529.MA.5Y | Population ages 25-29, male\ + \ (% of male population)\nSP.POP.3034.FE | Population ages 30-34, female\nSP.POP.3034.FE.5Y\ + \ | Population ages 30-34, female (% of female population)\nSP.POP.3034.MA | Population\ + \ ages 30-34, male\nSP.POP.3034.MA.5Y | Population ages 30-34, male (% of male population)\n\ + SP.POP.3539.FE | Population ages 35-39, female\nSP.POP.3539.FE.5Y | Population ages\ + \ 35-39, female (% of female population)\nSP.POP.3539.MA | Population ages 35-39,\ + \ male\nSP.POP.3539.MA.5Y | Population ages 35-39, male (% of male population)\n\ + SP.POP.4044.FE | Population ages 40-44, female\nSP.POP.4044.FE.5Y | Population ages\ + \ 40-44, female (% of female population)\nSP.POP.4044.MA | Population ages 40-44,\ + \ male\nSP.POP.4044.MA.5Y | Population ages 40-44, male (% of male population)\n\ + SP.POP.4549.FE | Population ages 45-49, female\nSP.POP.4549.FE.5Y | Population ages\ + \ 45-49, female (% of female population)\nSP.POP.4549.MA | Population ages 45-49,\ + \ male\nSP.POP.4549.MA.5Y | Population ages 45-49, male (% of male population)\n\ + SP.POP.5054.FE | Population ages 50-54, female\nSP.POP.5054.FE.5Y | Population ages\ + \ 50-54, female (% of female population)\nSP.POP.5054.MA | Population ages 50-54,\ + \ male\nSP.POP.5054.MA.5Y | Population ages 50-54, male (% of male population)\n\ + SP.POP.5559.FE | Population ages 55-59, female\nSP.POP.5559.FE.5Y | Population ages\ + \ 55-59, female (% of female population)\nSP.POP.5559.MA | Population ages 55-59,\ + \ male\nSP.POP.5559.MA.5Y | Population ages 55-59, male (% of male population)\n\ + SP.POP.6064.FE | Population ages 60-64, female\nSP.POP.6064.FE.5Y | Population ages\ + \ 60-64, female (% of female population)\nSP.POP.6064.MA | Population ages 60-64,\ + \ male\nSP.POP.6064.MA.5Y | Population ages 60-64, male (% of male population)\n\ + SP.POP.6569.FE | Population ages 65-69, female\nSP.POP.6569.FE.5Y | Population ages\ + \ 65-69, female (% of female population)\nSP.POP.6569.MA | Population ages 65-69,\ + \ male\nSP.POP.6569.MA.5Y | Population ages 65-69, male (% of male population)\n\ + SP.POP.65UP.FE.ZS | Population ages 65 and above, female (% of total)\nSP.POP.65UP.MA.ZS\ + \ | Population ages 65 and above, male (% of total)\nSP.POP.65UP.TO | Population\ + \ ages 65 and above, total\nSP.POP.65UP.TO.ZS | Population ages 65 and above (%\ + \ of total)\nSP.POP.7074.FE | Population ages 70-74, female\nSP.POP.7074.FE.5Y |\ + \ Population ages 70-74, female (% of female population)\nSP.POP.7074.MA | Population\ + \ ages 70-74, male\nSP.POP.7074.MA.5Y | Population ages 70-74, male (% of male population)\n\ + SP.POP.7579.FE | Population ages 75-79, female\nSP.POP.7579.FE.5Y | Population ages\ + \ 75-79, female (% of female population)\nSP.POP.7579.MA | Population ages 75-79,\ + \ male\nSP.POP.7579.MA.5Y | Population ages 75-79, male (% of male population)\n\ + SP.POP.80UP.FE | Population ages 80 and above, female\nSP.POP.80UP.FE.5Y | Population\ + \ ages 80 and above, female (% of female population)\nSP.POP.80UP.MA | Population\ + \ ages 80 and above, male\nSP.POP.80UP.MA.5Y | Population ages 80 and above, male\ + \ (% of male population)\nSP.POP.AG00.FE.IN | Age population, age 0, female, interpolated\n\ + SP.POP.AG00.MA.IN | Age population, age 0, male, interpolated\nSP.POP.AG01.FE.IN\ + \ | Age population, age 01, female, interpolated\nSP.POP.AG01.MA.IN | Age population,\ + \ age 01, male, interpolated\nSP.POP.AG02.FE.IN | Age population, age 02, female,\ + \ interpolated\nSP.POP.AG02.MA.IN | Age population, age 02, male, interpolated\n\ + SP.POP.AG03.FE.IN | Age population, age 03, female, interpolated\nSP.POP.AG03.MA.IN\ + \ | Age population, age 03, male, interpolated\nSP.POP.AG04.FE.IN | Age population,\ + \ age 04, female, interpolated\nSP.POP.AG04.MA.IN | Age population, age 04, male,\ + \ interpolated\nSP.POP.AG05.FE.IN | Age population, age 05, female, interpolated\n\ + SP.POP.AG05.MA.IN | Age population, age 05, male, interpolated\nSP.POP.AG06.FE.IN\ + \ | Age population, age 06, female, interpolated\nSP.POP.AG06.MA.IN | Age population,\ + \ age 06, male, interpolated\nSP.POP.AG07.FE.IN | Age population, age 07, female,\ + \ interpolated\nSP.POP.AG07.MA.IN | Age population, age 07, male, interpolated\n\ + SP.POP.AG08.FE.IN | Age population, age 08, female, interpolated\nSP.POP.AG08.MA.IN\ + \ | Age population, age 08, male, interpolated\nSP.POP.AG09.FE.IN | Age population,\ + \ age 09, female, interpolated\nSP.POP.AG09.MA.IN | Age population, age 09, male,\ + \ interpolated\nSP.POP.AG10.FE.IN | Age population, age 10, female, interpolated\n\ + SP.POP.AG10.MA.IN | Age population, age 10, male\nSP.POP.AG11.FE.IN | Age population,\ + \ age 11, female, interpolated\nSP.POP.AG11.MA.IN | Age population, age 11, male\n\ + SP.POP.AG12.FE.IN | Age population, age 12, female, interpolated\nSP.POP.AG12.MA.IN\ + \ | Age population, age 12, male\nSP.POP.AG13.FE.IN | Age population, age 13, female,\ + \ interpolated\nSP.POP.AG13.MA.IN | Age population, age 13, male\nSP.POP.AG14.FE.IN\ + \ | Age population, age 14, female, interpolated\nSP.POP.AG14.MA.IN | Age population,\ + \ age 14, male\nSP.POP.AG15.FE.IN | Age population, age 15, female, interpolated\n\ + SP.POP.AG15.MA.IN | Age population, age 15, male, interpolated\nSP.POP.AG16.FE.IN\ + \ | Age population, age 16, female, interpolated\nSP.POP.AG16.MA.IN | Age population,\ + \ age 16, male, interpolated\nSP.POP.AG17.FE.IN | Age population, age 17, female,\ + \ interpolated\nSP.POP.AG17.MA.IN | Age population, age 17, male, interpolated\n\ + SP.POP.AG18.FE.IN | Age population, age 18, female, interpolated\nSP.POP.AG18.MA.IN\ + \ | Age population, age 18, male, interpolated\nSP.POP.AG19.FE.IN | Age population,\ + \ age 19, female, interpolated\nSP.POP.AG19.MA.IN | Age population, age 19, male,\ + \ interpolated\nSP.POP.AG20.FE.IN | Age population, age 20, female, interpolated\n\ + SP.POP.AG20.MA.IN | Age population, age 20, male, interpolated\nSP.POP.AG21.FE.IN\ + \ | Age population, age 21, female, interpolated\nSP.POP.AG21.MA.IN | Age population,\ + \ age 21, male, interpolated\nSP.POP.AG22.FE.IN | Age population, age 22, female,\ + \ interpolated\nSP.POP.AG22.MA.IN | Age population, age 22, male, interpolated\n\ + SP.POP.AG23.FE.IN | Age population, age 23, female, interpolated\nSP.POP.AG23.MA.IN\ + \ | Age population, age 23, male, interpolated\nSP.POP.AG24.FE.IN | Age population,\ + \ age 24, female, interpolated\nSP.POP.AG24.MA.IN | Age population, age 24, male,\ + \ interpolated\nSP.POP.AG25.FE.IN | Age population, age 25, female, interpolated\n\ + SP.POP.AG25.MA.IN | Age population, age 25, male, interpolated\nSP.POP.BRTH.MF |\ + \ Sex ratio at birth (male births per female births)\nSP.POP.DPND | Age dependency\ + \ ratio (% of working-age population)\nSP.POP.DPND.OL | Age dependency ratio, old\ + \ (% of working-age population)\nSP.POP.DPND.YG | Age dependency ratio, young (%\ + \ of working-age population)\nSP.POP.GROW | Population growth (annual %)\nSP.POP.TOTL\ + \ | Population, total\nSP.POP.TOTL.FE.IN | Population, female\nSP.POP.TOTL.FE.ZS\ + \ | Population, female (% of total)\nSP.POP.TOTL.MA.IN | Population, male\nSP.POP.TOTL.MA.ZS\ + \ | Population, male (% of total)\nSP.REG.BRTH.RU.ZS | Completeness of birth registration,\ + \ rural (%)\nSP.REG.BRTH.UR.ZS | Completeness of birth registration, urban (%)\n\ + SP.REG.BRTH.ZS | Completeness of birth registration (%)\nSP.REG.DTHS.ZS | Completeness\ + \ of death registration with cause-of-death information (%)\nSP.RUR.TOTL | Rural\ + \ population\nSP.RUR.TOTL.ZG | Rural population growth (annual %)\nSP.RUR.TOTL.ZS\ + \ | Rural population (% of total population)\nSP.URB.GROW | Urban population growth\ + \ (annual %)\nSP.URB.TOTL | Urban population\nSP.URB.TOTL.IN.ZS | Urban population\ + \ (% of total)\nSP.UWT.TFRT | Unmet need for contraception (% of married women ages\ + \ 15-49)\n" +extra: null +fetch_values_predicate: null +filter_select_enabled: true +folders: null +main_dttm_col: year +metrics: +- currency: null + d3format: null + description: null + expression: sum("SP_POP_TOTL") + extra: null + metric_name: sum__SP_POP_TOTL + metric_type: null + verbose_name: null + warning_text: null +- currency: null + d3format: null + description: null + expression: sum("SH_DYN_AIDS") + extra: null + metric_name: sum__SH_DYN_AIDS + metric_type: null + verbose_name: null + warning_text: null +- currency: null + d3format: null + description: null + expression: sum("SP_RUR_TOTL_ZS") + extra: null + metric_name: sum__SP_RUR_TOTL_ZS + metric_type: null + verbose_name: null + warning_text: null +- currency: null + d3format: null + description: null + expression: sum("SP_DYN_LE00_IN") + extra: null + metric_name: sum__SP_DYN_LE00_IN + metric_type: null + verbose_name: null + warning_text: null +- currency: null + d3format: null + description: null + expression: sum("SP_RUR_TOTL") + extra: null + metric_name: sum__SP_RUR_TOTL + metric_type: null + verbose_name: null + warning_text: null +- currency: null + d3format: null + description: null + expression: COUNT(*) + extra: null + metric_name: count + metric_type: count + verbose_name: COUNT(*) + warning_text: null +normalize_columns: false +offset: 0 +params: null +schema: null +sql: null +table_name: wb_health_population +template_params: null +uuid: 69e9de42-fe7f-4948-946a-f7913227aee8 +version: 1.0.0 diff --git a/superset/examples/misc_dashboard.py b/superset/examples/misc_dashboard.py deleted file mode 100644 index 75ad8147f7f..00000000000 --- a/superset/examples/misc_dashboard.py +++ /dev/null @@ -1,145 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -import logging -import textwrap - -from superset import db -from superset.models.dashboard import Dashboard -from superset.utils import json - -from .helpers import update_slice_ids - -logger = logging.getLogger(__name__) - -DASH_SLUG = "misc_charts" - - -def load_misc_dashboard() -> None: - """Loading a dashboard featuring misc charts""" - - logger.debug("Creating the dashboard") - db.session.expunge_all() - dash = db.session.query(Dashboard).filter_by(slug=DASH_SLUG).first() - - if not dash: - dash = Dashboard() - db.session.add(dash) - js = textwrap.dedent( - """\ -{ - "CHART-HJOYVMV0E7": { - "children": [], - "id": "CHART-HJOYVMV0E7", - "meta": { - "chartId": 3969, - "height": 69, - "sliceName": "OSM Long/Lat", - "uuid": "164efe31-295b-4408-aaa6-2f4bfb58a212", - "width": 4 - }, - "parents": [ - "ROOT_ID", - "GRID_ID", - "ROW-S1MK4M4A4X", - "COLUMN-ByUFVf40EQ" - ], - "type": "CHART" - }, - "CHART-S1WYNz4AVX": { - "children": [], - "id": "CHART-S1WYNz4AVX", - "meta": { - "chartId": 3989, - "height": 69, - "sliceName": "Parallel Coordinates", - "uuid": "e84f7e74-031a-47bb-9f80-ae0694dcca48", - "width": 4 - }, - "parents": [ - "ROOT_ID", - "GRID_ID", - "ROW-SytNzNA4X" - ], - "type": "CHART" - }, - "CHART-rkgF4G4A4X": { - "children": [], - "id": "CHART-rkgF4G4A4X", - "meta": { - "chartId": 3970, - "height": 69, - "sliceName": "Birth in France by department in 2016", - "uuid": "54583ae9-c99a-42b5-a906-7ee2adfe1fb1", - "width": 4 - }, - "parents": [ - "ROOT_ID", - "GRID_ID", - "ROW-SytNzNA4X" - ], - "type": "CHART" - }, - "DASHBOARD_VERSION_KEY": "v2", - "GRID_ID": { - "children": [ - "ROW-SytNzNA4X" - ], - "id": "GRID_ID", - "parents": [ - "ROOT_ID" - ], - "type": "GRID" - }, - "HEADER_ID": { - "id": "HEADER_ID", - "meta": { - "text": "Misc Charts" - }, - "type": "HEADER" - }, - "ROOT_ID": { - "children": [ - "GRID_ID" - ], - "id": "ROOT_ID", - "type": "ROOT" - }, - "ROW-SytNzNA4X": { - "children": [ - "CHART-rkgF4G4A4X", - "CHART-S1WYNz4AVX", - "CHART-HJOYVMV0E7" - ], - "id": "ROW-SytNzNA4X", - "meta": { - "background": "BACKGROUND_TRANSPARENT" - }, - "parents": [ - "ROOT_ID", - "GRID_ID" - ], - "type": "ROW" - } -} - """ - ) - pos = json.loads(js) - slices = update_slice_ids(pos) - dash.dashboard_title = "Misc Charts" - dash.position_json = json.dumps(pos, indent=4) - dash.slug = DASH_SLUG - dash.slices = slices diff --git a/superset/examples/multiformat_time_series.py b/superset/examples/multiformat_time_series.py deleted file mode 100644 index 1938beb5f44..00000000000 --- a/superset/examples/multiformat_time_series.py +++ /dev/null @@ -1,135 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -import logging -from typing import Optional - -import pandas as pd -from flask import current_app -from sqlalchemy import BigInteger, Date, DateTime, inspect, String - -from superset import db -from superset.models.slice import Slice -from superset.sql.parse import Table -from superset.utils.core import DatasourceType - -from ..utils.database import get_example_database # noqa: TID252 -from .helpers import ( - get_slice_json, - get_table_connector_registry, - merge_slice, - misc_dash_slices, - read_example_data, -) - -logger = logging.getLogger(__name__) - - -def load_multiformat_time_series( # pylint: disable=too-many-locals - only_metadata: bool = False, force: bool = False -) -> None: - """Loading time series data from a zip file in the repo""" - tbl_name = "multiformat_time_series" - database = get_example_database() - with database.get_sqla_engine() as engine: - schema = inspect(engine).default_schema_name - table_exists = database.has_table(Table(tbl_name, schema)) - - if not only_metadata and (not table_exists or force): - pdf = read_example_data( - "examples://multiformat_time_series.json.gz", compression="gzip" - ) - - # TODO(bkyryliuk): move load examples data into the pytest fixture - if database.backend == "presto": - pdf.ds = pd.to_datetime(pdf.ds, unit="s") - pdf.ds = pdf.ds.dt.strftime("%Y-%m-%d") - pdf.ds2 = pd.to_datetime(pdf.ds2, unit="s") - pdf.ds2 = pdf.ds2.dt.strftime("%Y-%m-%d %H:%M%:%S") - else: - pdf.ds = pd.to_datetime(pdf.ds, unit="s") - pdf.ds2 = pd.to_datetime(pdf.ds2, unit="s") - - pdf.to_sql( - tbl_name, - engine, - schema=schema, - if_exists="replace", - chunksize=500, - dtype={ - "ds": String(255) if database.backend == "presto" else Date, - "ds2": String(255) if database.backend == "presto" else DateTime, - "epoch_s": BigInteger, - "epoch_ms": BigInteger, - "string0": String(100), - "string1": String(100), - "string2": String(100), - "string3": String(100), - }, - index=False, - ) - logger.debug("Done loading table!") - logger.debug("-" * 80) - - logger.debug("Creating table [%s] reference", tbl_name) - table = get_table_connector_registry() - obj = db.session.query(table).filter_by(table_name=tbl_name).first() - if not obj: - obj = table(table_name=tbl_name, schema=schema) - db.session.add(obj) - obj.main_dttm_col = "ds" - obj.database = database - obj.filter_select_enabled = True - dttm_and_expr_dict: dict[str, tuple[Optional[str], None]] = { - "ds": (None, None), - "ds2": (None, None), - "epoch_s": ("epoch_s", None), - "epoch_ms": ("epoch_ms", None), - "string2": ("%Y%m%d-%H%M%S", None), - "string1": ("%Y-%m-%d^%H:%M:%S", None), - "string0": ("%Y-%m-%d %H:%M:%S.%f", None), - "string3": ("%Y/%m/%d%H:%M:%S.%f", None), - } - for col in obj.columns: - dttm_and_expr = dttm_and_expr_dict[col.column_name] - col.python_date_format = dttm_and_expr[0] - col.database_expression = dttm_and_expr[1] - col.is_dttm = True - obj.fetch_metadata() - tbl = obj - - logger.debug("Creating Heatmap charts") - for i, col in enumerate(tbl.columns): - slice_data = { - "metrics": ["count"], - "granularity_sqla": col.column_name, - "row_limit": current_app.config["ROW_LIMIT"], - "since": "2015", - "until": "2016", - "viz_type": "cal_heatmap", - "domain_granularity": "month", - "subdomain_granularity": "day", - } - - slc = Slice( - slice_name="Calendar Heatmap multiformat %s" % i, - viz_type="cal_heatmap", - datasource_type=DatasourceType.TABLE, - datasource_id=tbl.id, - params=get_slice_json(slice_data), - ) - merge_slice(slc) - misc_dash_slices.add("Calendar Heatmap multiformat 0") diff --git a/superset/examples/paris.py b/superset/examples/paris.py deleted file mode 100644 index 9fadf0b019f..00000000000 --- a/superset/examples/paris.py +++ /dev/null @@ -1,67 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. - -import logging - -from sqlalchemy import inspect, String, Text - -import superset.utils.database as database_utils -from superset import db -from superset.sql.parse import Table -from superset.utils import json - -from .helpers import get_table_connector_registry, read_example_data - -logger = logging.getLogger(__name__) - - -def load_paris_iris_geojson(only_metadata: bool = False, force: bool = False) -> None: - tbl_name = "paris_iris_mapping" - database = database_utils.get_example_database() - with database.get_sqla_engine() as engine: - schema = inspect(engine).default_schema_name - table_exists = database.has_table(Table(tbl_name, schema)) - - if not only_metadata and (not table_exists or force): - df = read_example_data("examples://paris_iris.json.gz", compression="gzip") - df["features"] = df.features.map(json.dumps) - - df.to_sql( - tbl_name, - engine, - schema=schema, - if_exists="replace", - chunksize=500, - dtype={ - "color": String(255), - "name": String(255), - "features": Text, - "type": Text, - }, - index=False, - ) - - logger.debug("Creating table %s reference", tbl_name) - table = get_table_connector_registry() - tbl = db.session.query(table).filter_by(table_name=tbl_name).first() - if not tbl: - tbl = table(table_name=tbl_name, schema=schema) - db.session.add(tbl) - tbl.description = "Map of Paris" - tbl.database = database - tbl.filter_select_enabled = True - tbl.fetch_metadata() diff --git a/superset/examples/random_time_series.py b/superset/examples/random_time_series.py deleted file mode 100644 index c77ef0ed8c4..00000000000 --- a/superset/examples/random_time_series.py +++ /dev/null @@ -1,102 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -import logging - -import pandas as pd -from flask import current_app -from sqlalchemy import DateTime, inspect, String - -import superset.utils.database as database_utils -from superset import db -from superset.models.slice import Slice -from superset.sql.parse import Table -from superset.utils.core import DatasourceType - -from .helpers import ( - get_slice_json, - get_table_connector_registry, - merge_slice, - read_example_data, -) - -logger = logging.getLogger(__name__) - - -def load_random_time_series_data( - only_metadata: bool = False, force: bool = False -) -> None: - """Loading random time series data from a zip file in the repo""" - tbl_name = "random_time_series" - database = database_utils.get_example_database() - with database.get_sqla_engine() as engine: - schema = inspect(engine).default_schema_name - table_exists = database.has_table(Table(tbl_name, schema)) - - if not only_metadata and (not table_exists or force): - pdf = read_example_data( - "examples://random_time_series.json.gz", compression="gzip" - ) - if database.backend == "presto": - pdf.ds = pd.to_datetime(pdf.ds, unit="s") - pdf.ds = pdf.ds.dt.strftime("%Y-%m-%d %H:%M%:%S") - else: - pdf.ds = pd.to_datetime(pdf.ds, unit="s") - - pdf.to_sql( - tbl_name, - engine, - schema=schema, - if_exists="replace", - chunksize=500, - dtype={"ds": DateTime if database.backend != "presto" else String(255)}, - index=False, - ) - logger.debug("Done loading table!") - logger.debug("-" * 80) - - logger.debug("Creating table [%s] reference", tbl_name) - table = get_table_connector_registry() - obj = db.session.query(table).filter_by(table_name=tbl_name).first() - if not obj: - obj = table(table_name=tbl_name, schema=schema) - db.session.add(obj) - obj.main_dttm_col = "ds" - obj.database = database - obj.filter_select_enabled = True - obj.fetch_metadata() - tbl = obj - - slice_data = { - "granularity_sqla": "ds", - "row_limit": current_app.config["ROW_LIMIT"], - "since": "2019-01-01", - "until": "2019-02-01", - "metrics": ["count"], - "viz_type": "cal_heatmap", - "domain_granularity": "month", - "subdomain_granularity": "day", - } - - logger.debug("Creating a slice") - slc = Slice( - slice_name="Calendar Heatmap", - viz_type="cal_heatmap", - datasource_type=DatasourceType.TABLE, - datasource_id=tbl.id, - params=get_slice_json(slice_data), - ) - merge_slice(slc) diff --git a/superset/examples/configs/charts/Vehicle Sales/Total_Items_Sold.yaml b/superset/examples/sales_dashboard/charts/Items_Sold.yaml similarity index 71% rename from superset/examples/configs/charts/Vehicle Sales/Total_Items_Sold.yaml rename to superset/examples/sales_dashboard/charts/Items_Sold.yaml index 5ccd733336c..c6cc9ee9f5b 100644 --- a/superset/examples/configs/charts/Vehicle Sales/Total_Items_Sold.yaml +++ b/superset/examples/sales_dashboard/charts/Items_Sold.yaml @@ -14,12 +14,28 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Total Items Sold -viz_type: big_number_total +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null params: - adhoc_filters: [] - datasource: 23__table - granularity_sqla: order_date + adhoc_filters: + - clause: WHERE + comparator: No filter + expressionType: SIMPLE + operator: TEMPORAL_RANGE + subject: order_date + annotation_layers: [] + color_picker: + a: 1 + b: 135 + g: 122 + r: 0 + dashboards: + - 9 + datasource: 21__table + extra_form_data: {} header_font_size: 0.4 metric: aggregate: SUM @@ -40,15 +56,17 @@ params: label: SUM(Sales) optionName: metric_twq59hf4ej_g70qjfmehsq sqlExpression: null - queryFields: - metric: metrics - subheader: '' + rolling_type: cumsum + show_trend_line: true + slice_id: 115 + start_y_axis_at_zero: true subheader_font_size: 0.15 - time_range: No filter - url_params: {} - viz_type: big_number_total + time_format: smart_date + viz_type: big_number + x_axis: order_date y_axis_format: SMART_NUMBER -cache_timeout: null +query_context: null +slice_name: Items Sold uuid: c3d643cd-fd6f-4659-a5b7-59402487a8d0 version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +viz_type: big_number diff --git a/superset/examples/configs/charts/Vehicle Sales/Number_of_Deals_for_each_Combination.yaml b/superset/examples/sales_dashboard/charts/Number_of_Deals_for_each_Combination.yaml similarity index 100% rename from superset/examples/configs/charts/Vehicle Sales/Number_of_Deals_for_each_Combination.yaml rename to superset/examples/sales_dashboard/charts/Number_of_Deals_for_each_Combination.yaml index 379b353cb78..1d5c56a6748 100644 --- a/superset/examples/configs/charts/Vehicle Sales/Number_of_Deals_for_each_Combination.yaml +++ b/superset/examples/sales_dashboard/charts/Number_of_Deals_for_each_Combination.yaml @@ -14,18 +14,18 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Number of Deals (for each Combination) -description: null -certified_by: null +cache_timeout: null certification_details: null -viz_type: heatmap_v2 +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null params: adhoc_filters: [] - x_axis: deal_size - groupby: product_line + annotation_layers: [] bottom_margin: 100 datasource: 23__table granularity_sqla: order_date + groupby: product_line left_margin: 75 linear_color_scheme: schemePuBuGn metric: count @@ -42,16 +42,16 @@ params: sort_y_axis: alpha_asc time_range: No filter url_params: {} - viz_type: heatmap_v2 - xscale_interval: null value_bounds: - null - null + viz_type: heatmap_v2 + x_axis: deal_size + xscale_interval: null y_axis_format: SMART_NUMBER yscale_interval: null - annotation_layers: [] query_context: null -cache_timeout: null +slice_name: Number of Deals (for each Combination) uuid: bd20fc69-dd51-46c1-99b5-09e37a434bf1 version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +viz_type: heatmap_v2 diff --git a/superset/examples/configs/charts/COVID Vaccines/Vaccine_Candidates_per_Country_261.yaml b/superset/examples/sales_dashboard/charts/Overall_Sales_By_Product_Line.yaml similarity index 56% rename from superset/examples/configs/charts/COVID Vaccines/Vaccine_Candidates_per_Country_261.yaml rename to superset/examples/sales_dashboard/charts/Overall_Sales_By_Product_Line.yaml index b598fb2dbbb..bca01b32601 100644 --- a/superset/examples/configs/charts/COVID Vaccines/Vaccine_Candidates_per_Country_261.yaml +++ b/superset/examples/sales_dashboard/charts/Overall_Sales_By_Product_Line.yaml @@ -14,46 +14,59 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Vaccine Candidates per Country -viz_type: world_map +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null params: adhoc_filters: [] - color_picker: - a: 1 - b: 135 - g: 122 - r: 0 - country_fieldtype: name - datasource: 14__table - entity: country_name - linear_color_scheme: schemeYlOrBr - max_bubble_size: '25' - metric: count - row_limit: 10000 - secondary_metric: - aggregate: COUNT + annotation_layers: [] + color_scheme: supersetColors + datasource: 23__table + donut: true + granularity_sqla: order_date + groupby: + - product_line + innerRadius: 41 + label_line: true + label_type: key + labels_outside: true + metric: + aggregate: SUM column: - column_name: country_name + column_name: sales description: null expression: null filterable: true groupby: true - id: 583 + id: 917 is_dttm: false + optionName: _col_Sales python_date_format: null - type: TEXT + type: DOUBLE PRECISION verbose_name: null expressionType: SIMPLE hasCustomLabel: false isNew: false - label: COUNT(Country_Name) - optionName: metric_i8otphezfu_5urmjjs7c1 + label: (Sales) + optionName: metric_3sk6pfj3m7i_64h77bs4sly sqlExpression: null - show_bubbles: true + number_format: SMART_NUMBER + outerRadius: 65 + queryFields: + groupby: groupby + metric: metrics + row_limit: null + show_labels: true + show_labels_threshold: 2 + show_legend: false + slice_id: 670 time_range: No filter url_params: {} - viz_type: world_map -cache_timeout: null -uuid: ddc91df6-fb40-4826-bdca-16b85af1c024 + viz_type: pie +query_context: null +slice_name: Overall Sales (By Product Line) +uuid: 09c497e0-f442-1121-c9e7-671e37750424 version: 1.0.0 -dataset_uuid: 974b7a1c-22ea-49cb-9214-97b7dbd511e0 +viz_type: pie diff --git a/superset/examples/sales_dashboard/charts/Proportion_of_Revenue_by_Product_Line.yaml b/superset/examples/sales_dashboard/charts/Proportion_of_Revenue_by_Product_Line.yaml new file mode 100644 index 00000000000..ee3fe84978d --- /dev/null +++ b/superset/examples/sales_dashboard/charts/Proportion_of_Revenue_by_Product_Line.yaml @@ -0,0 +1,94 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null +params: + adhoc_filters: + - clause: WHERE + comparator: '2003-01-01T00:00:00 : 2005-06-01T00:00:00' + expressionType: SIMPLE + operator: TEMPORAL_RANGE + subject: order_date + annotation_layers: [] + color_scheme: supersetColors + comparison_type: values + dashboards: + - 9 + datasource: 21__table + extra_form_data: {} + forecastInterval: 0.8 + forecastPeriods: 10 + groupby: + - product_line + legendOrientation: top + legendType: scroll + markerSize: 6 + metrics: + - aggregate: SUM + column: + column_name: sales + description: null + expression: null + filterable: true + groupby: true + id: 917 + is_dttm: false + optionName: _col_Sales + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null + expressionType: SIMPLE + hasCustomLabel: false + isNew: false + label: (Sales) + optionName: metric_3is69ofceho_6d0ezok7ry6 + sqlExpression: null + only_total: true + opacity: 0.2 + rich_tooltip: true + rolling_type: null + row_limit: null + seriesType: line + showTooltipTotal: true + show_empty_columns: true + show_legend: true + slice_id: 116 + sort_series_type: sum + stack: Stack + time_grain_sqla: P1M + time_shift_color: true + tooltipTimeFormat: smart_date + truncateXAxis: true + truncate_metric: true + viz_type: echarts_area + x_axis: order_date + x_axis_sort_asc: true + x_axis_sort_series: name + x_axis_sort_series_ascending: true + x_axis_time_format: smart_date + x_axis_title_margin: 15 + y_axis_format: SMART_NUMBER + y_axis_title_margin: 15 + y_axis_title_position: Left +query_context: null +slice_name: Proportion of Revenue by Product Line +uuid: 08aff161-f60c-4cb3-a225-dc9b1140d2e3 +version: 1.0.0 +viz_type: echarts_area diff --git a/superset/examples/sales_dashboard/charts/Quarterly_Sales.yaml b/superset/examples/sales_dashboard/charts/Quarterly_Sales.yaml new file mode 100644 index 00000000000..443cf8f81f7 --- /dev/null +++ b/superset/examples/sales_dashboard/charts/Quarterly_Sales.yaml @@ -0,0 +1,96 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null +params: + adhoc_filters: + - clause: WHERE + comparator: No filter + expressionType: SIMPLE + operator: TEMPORAL_RANGE + subject: order_date + annotation_layers: [] + color_scheme: supersetColors + comparison_type: null + dashboards: + - 9 + datasource: 21__table + extra_form_data: {} + forecastInterval: 0.8 + forecastPeriods: 10 + groupby: + - status + legendOrientation: top + legendType: scroll + metrics: + - aggregate: SUM + column: + column_name: sales + description: null + expression: null + filterable: true + groupby: true + id: 917 + is_dttm: false + optionName: _col_Sales + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null + expressionType: SIMPLE + hasCustomLabel: false + isNew: false + label: SUM(Sales) + optionName: metric_tjn8bh6y44_7o4etwsqhal + sqlExpression: null + only_total: true + orientation: vertical + rich_tooltip: true + rolling_type: null + row_limit: 10000 + showTooltipTotal: true + show_empty_columns: true + show_legend: true + slice_id: 118 + sort_series_type: sum + stack: Stack + time_compare: null + time_grain_sqla: P3M + time_shift_color: true + tooltipTimeFormat: smart_date + truncateXAxis: true + truncate_metric: true + viz_type: echarts_timeseries_bar + x_axis: order_date + x_axis_sort_asc: true + x_axis_sort_series: name + x_axis_sort_series_ascending: true + x_axis_time_format: smart_date + x_axis_title_margin: 15 + y_axis_bounds: + - null + - null + y_axis_format: null + y_axis_title_margin: 15 + y_axis_title_position: Left +query_context: null +slice_name: Quarterly Sales +uuid: 692aca26-a526-85db-c94c-411c91cc1077 +version: 1.0.0 +viz_type: echarts_timeseries_bar diff --git a/superset/examples/configs/charts/Vehicle Sales/Quarterly_Sales_By_Product_Line.yaml b/superset/examples/sales_dashboard/charts/Quarterly_Sales_By_Product_Line.yaml similarity index 66% rename from superset/examples/configs/charts/Vehicle Sales/Quarterly_Sales_By_Product_Line.yaml rename to superset/examples/sales_dashboard/charts/Quarterly_Sales_By_Product_Line.yaml index 7f5e039c8e5..57ce0336053 100644 --- a/superset/examples/configs/charts/Vehicle Sales/Quarterly_Sales_By_Product_Line.yaml +++ b/superset/examples/sales_dashboard/charts/Quarterly_Sales_By_Product_Line.yaml @@ -14,8 +14,11 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Quarterly Sales (By Product Line) -viz_type: echarts_timeseries_bar +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null params: adhoc_filters: [] annotation_layers: [] @@ -26,39 +29,39 @@ params: datasource: 23__table granularity_sqla: order_date groupby: - - product_line + - product_line label_colors: - Classic Cars: "#5AC189" - Motorcycles: "#666666" - Planes: "#FCC700" - QuantityOrdered: "#454E7C" - SUM(Sales): "#1FA8C9" - Ships: "#A868B7" - Trains: "#3CCCCB" - Trucks and Buses: "#E04355" - Vintage Cars: "#FF7F44" + Classic Cars: '#5AC189' + Motorcycles: '#666666' + Planes: '#FCC700' + QuantityOrdered: '#454E7C' + SUM(Sales): '#1FA8C9' + Ships: '#A868B7' + Trains: '#3CCCCB' + Trucks and Buses: '#E04355' + Vintage Cars: '#FF7F44' left_margin: auto line_interpolation: linear metrics: - - aggregate: SUM - column: - column_name: sales - description: null - expression: null - filterable: true - groupby: true - id: 917 - is_dttm: false - optionName: _col_Sales - python_date_format: null - type: DOUBLE PRECISION - verbose_name: null - expressionType: SIMPLE - hasCustomLabel: false - isNew: false - label: SUM(Sales) - optionName: metric_tjn8bh6y44_7o4etwsqhal - sqlExpression: null + - aggregate: SUM + column: + column_name: sales + description: null + expression: null + filterable: true + groupby: true + id: 917 + is_dttm: false + optionName: _col_Sales + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null + expressionType: SIMPLE + hasCustomLabel: false + isNew: false + label: SUM(Sales) + optionName: metric_tjn8bh6y44_7o4etwsqhal + sqlExpression: null order_desc: true queryFields: groupby: groupby @@ -75,15 +78,16 @@ params: time_range: No filter url_params: {} viz_type: echarts_timeseries_bar - x_axis_format: "%m/%d/%Y" + x_axis_format: '%m/%d/%Y' x_axis_label: Quarter starting - x_ticks_layout: "45\xB0" + x_ticks_layout: 45° y_axis_bounds: - - null - - null + - null + - null y_axis_format: null y_axis_label: Revenue ($) -cache_timeout: null +query_context: null +slice_name: Quarterly Sales (By Product Line) uuid: db9609e4-9b78-4a32-87a7-4d9e19d51cd8 version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +viz_type: echarts_timeseries_bar diff --git a/superset/examples/configs/charts/Vehicle Sales/Revenue_by_Deal_Size.yaml b/superset/examples/sales_dashboard/charts/Revenue_by_Deal_Size.yaml similarity index 100% rename from superset/examples/configs/charts/Vehicle Sales/Revenue_by_Deal_Size.yaml rename to superset/examples/sales_dashboard/charts/Revenue_by_Deal_Size.yaml index 0f08edd3c89..6ae9d1554ca 100644 --- a/superset/examples/configs/charts/Vehicle Sales/Revenue_by_Deal_Size.yaml +++ b/superset/examples/sales_dashboard/charts/Revenue_by_Deal_Size.yaml @@ -14,11 +14,11 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Revenue by Deal Size -description: null -certified_by: null +cache_timeout: null certification_details: null -viz_type: echarts_timeseries_bar +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null params: adhoc_filters: [] annotation_layers: [] @@ -74,7 +74,7 @@ params: - null y_axis_format: SMART_NUMBER query_context: null -cache_timeout: null +slice_name: Revenue by Deal Size uuid: f065a533-2e13-42b9-bd19-801a21700dff version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +viz_type: echarts_timeseries_bar diff --git a/superset/examples/configs/charts/Vehicle Sales/Seasonality_of_Revenue_per_Product_Line.yaml b/superset/examples/sales_dashboard/charts/Seasonality_of_Revenue_per_Product_Line.yaml similarity index 100% rename from superset/examples/configs/charts/Vehicle Sales/Seasonality_of_Revenue_per_Product_Line.yaml rename to superset/examples/sales_dashboard/charts/Seasonality_of_Revenue_per_Product_Line.yaml index 5b91dd1c588..332dace5a11 100644 --- a/superset/examples/configs/charts/Vehicle Sales/Seasonality_of_Revenue_per_Product_Line.yaml +++ b/superset/examples/sales_dashboard/charts/Seasonality_of_Revenue_per_Product_Line.yaml @@ -14,13 +14,14 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Seasonality of Revenue (per Product Line) -description: null -certified_by: null +cache_timeout: null certification_details: null -viz_type: horizon +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null params: adhoc_filters: [] + annotation_layers: [] datasource: 23__table granularity_sqla: order_date groupby: @@ -56,9 +57,8 @@ params: time_range: No filter url_params: {} viz_type: horizon - annotation_layers: [] query_context: null -cache_timeout: null +slice_name: Seasonality of Revenue (per Product Line) uuid: cf0da099-b3ab-4d94-ab62-cf353ac3c611 version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +viz_type: horizon diff --git a/superset/examples/configs/charts/Vehicle Sales/Total_Items_Sold_By_Product_Line.yaml b/superset/examples/sales_dashboard/charts/Total_Items_Sold_By_Product_Line.yaml similarity index 94% rename from superset/examples/configs/charts/Vehicle Sales/Total_Items_Sold_By_Product_Line.yaml rename to superset/examples/sales_dashboard/charts/Total_Items_Sold_By_Product_Line.yaml index 15334677129..3fae4fdd2c2 100644 --- a/superset/examples/configs/charts/Vehicle Sales/Total_Items_Sold_By_Product_Line.yaml +++ b/superset/examples/sales_dashboard/charts/Total_Items_Sold_By_Product_Line.yaml @@ -14,11 +14,15 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Total Items Sold (By Product Line) -viz_type: table +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null params: adhoc_filters: [] all_columns: [] + annotation_layers: [] color_pn: true datasource: 23__table granularity_sqla: order_date @@ -59,7 +63,8 @@ params: time_range: No filter url_params: {} viz_type: table -cache_timeout: null +query_context: null +slice_name: Total Items Sold (By Product Line) uuid: b8b7ca30-6291-44b0-bc64-ba42e2892b86 version: 1.0.0 -dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +viz_type: table diff --git a/superset/examples/sales_dashboard/charts/Total_Revenue.yaml b/superset/examples/sales_dashboard/charts/Total_Revenue.yaml new file mode 100644 index 00000000000..bd6036de683 --- /dev/null +++ b/superset/examples/sales_dashboard/charts/Total_Revenue.yaml @@ -0,0 +1,76 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: e8623bb9-5e00-f531-506a-19607f5f8005 +description: null +params: + adhoc_filters: + - clause: WHERE + comparator: No filter + expressionType: SIMPLE + operator: TEMPORAL_RANGE + subject: order_date + annotation_layers: [] + color_picker: + a: 1 + b: 135 + g: 122 + r: 0 + currency_format: + symbol: USD + symbolPosition: prefix + dashboards: + - 9 + datasource: 21__table + extra_form_data: {} + header_font_size: 0.4 + metric: + aggregate: SUM + column: + column_name: sales + description: null + expression: null + filterable: true + groupby: true + id: 917 + is_dttm: false + optionName: _col_Sales + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null + expressionType: SIMPLE + hasCustomLabel: false + isNew: false + label: (Sales) + optionName: metric_twq59hf4ej_g70qjfmehsq + sqlExpression: null + rolling_type: cumsum + show_trend_line: true + slice_id: 114 + start_y_axis_at_zero: true + subheader_font_size: 0.15 + time_format: smart_date + viz_type: big_number + x_axis: order_date + y_axis_format: .3s +query_context: null +slice_name: Total Revenue +uuid: 7b12a243-88e0-4dc5-ac33-9a840bb0ac5a +version: 1.0.0 +viz_type: big_number diff --git a/superset/examples/configs/dashboards/Sales_Dashboard.yaml b/superset/examples/sales_dashboard/dashboard.yaml similarity index 87% rename from superset/examples/configs/dashboards/Sales_Dashboard.yaml rename to superset/examples/sales_dashboard/dashboard.yaml index 6af9bdde6e0..321e57d5bd6 100644 --- a/superset/examples/configs/dashboards/Sales_Dashboard.yaml +++ b/superset/examples/sales_dashboard/dashboard.yaml @@ -14,20 +14,420 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. +certification_details: '' +certified_by: '' +css: '' dashboard_title: Sales Dashboard description: null -css: '' -slug: null -certified_by: '' -certification_details: '' -published: true -uuid: 04f79081-fb49-7bac-7f14-cc76cd2ad93b +metadata: + chart_configuration: + 08aff161-f60c-4cb3-a225-dc9b1140d2e3: + crossFilters: + chartsInScope: + - 111 + - 112 + - 113 + - 114 + - 115 + - 117 + - 118 + - 119 + - 120 + scope: global + id: 08aff161-f60c-4cb3-a225-dc9b1140d2e3 + 09c497e0-f442-1121-c9e7-671e37750424: + crossFilters: + chartsInScope: + - 111 + - 112 + - 113 + - 114 + - 115 + - 116 + - 117 + - 118 + - 119 + scope: global + id: 09c497e0-f442-1121-c9e7-671e37750424 + 692aca26-a526-85db-c94c-411c91cc1077: + crossFilters: + chartsInScope: + - 111 + - 112 + - 113 + - 114 + - 115 + - 116 + - 117 + - 119 + - 120 + scope: global + id: 692aca26-a526-85db-c94c-411c91cc1077 + b8b7ca30-6291-44b0-bc64-ba42e2892b86: + crossFilters: + chartsInScope: + - 112 + - 113 + - 114 + - 115 + - 116 + - 117 + - 118 + - 119 + - 120 + scope: global + id: b8b7ca30-6291-44b0-bc64-ba42e2892b86 + db9609e4-9b78-4a32-87a7-4d9e19d51cd8: + crossFilters: + chartsInScope: + - 111 + - 112 + - 114 + - 115 + - 116 + - 117 + - 118 + - 119 + - 120 + scope: global + id: db9609e4-9b78-4a32-87a7-4d9e19d51cd8 + f065a533-2e13-42b9-bd19-801a21700dff: + crossFilters: + chartsInScope: + - 111 + - 112 + - 113 + - 114 + - 115 + - 116 + - 118 + - 119 + - 120 + scope: global + id: f065a533-2e13-42b9-bd19-801a21700dff + color_scheme: supersetColors + color_scheme_domain: + - '#1FA8C9' + - '#454E7C' + - '#5AC189' + - '#FF7F44' + - '#666666' + - '#E04355' + - '#FCC700' + - '#A868B7' + - '#3CCCCB' + - '#A38F79' + - '#8FD3E4' + - '#A1A6BD' + - '#ACE1C4' + - '#FEC0A1' + - '#B2B2B2' + - '#EFA1AA' + - '#FDE380' + - '#D3B3DA' + - '#9EE5E5' + - '#D1C6BC' + cross_filters_enabled: true + default_filters: '{}' + expanded_slices: {} + global_chart_configuration: + chartsInScope: + - 111 + - 112 + - 113 + - 114 + - 115 + - 116 + - 117 + - 118 + - 119 + - 120 + scope: + excluded: [] + rootPath: + - ROOT_ID + label_colors: + Classic Cars: '#454E7C' + Large: '#5AC189' + Medium: '#1FA8C9' + Motorcycles: '#FF7F44' + Planes: '#E04355' + SUM(SALES): '#1FA8C9' + Ships: '#FCC700' + Small: '#454E7C' + Trains: '#A868B7' + Trucks and Buses: '#666666' + Vintage Cars: '#5AC189' + map_label_colors: + Cancelled: '#454E7C' + Disputed: '#E04355' + In Process: '#666666' + On Hold: '#5AC189' + Resolved: '#FF7F44' + Shipped: '#1FA8C9' + native_filter_configuration: + - cascadeParentIds: [] + chartsInScope: + - 111 + - 112 + - 113 + - 114 + - 115 + - 116 + - 117 + - 118 + - 119 + - 120 + controlValues: + defaultToFirstItem: false + enableEmptyFilter: false + inverseSelection: false + multiSelect: true + searchAllOptions: false + defaultDataMask: + extraFormData: {} + filterState: {} + ownState: {} + description: '' + filterType: filter_select + id: NATIVE_FILTER-HX2lV--YaAZRQfJ_yfYB2 + name: Country + scope: + excluded: [] + rootPath: + - ROOT_ID + tabsInScope: + - TAB-d-E0Zc1cTH + - TAB-4fthLQmdX + targets: + - column: + name: country + datasetUuid: e8623bb9-5e00-f531-506a-19607f5f8005 + type: NATIVE_FILTER + - cascadeParentIds: [] + chartsInScope: + - 111 + - 112 + - 113 + - 114 + - 115 + - 116 + - 117 + - 118 + - 119 + - 120 + controlValues: + enableEmptyFilter: false + defaultDataMask: + extraFormData: {} + filterState: {} + ownState: {} + description: '' + filterType: filter_range + id: NATIVE_FILTER-oCF7UtoHuDIBg44q5peth + name: Order Quantity + scope: + excluded: [] + rootPath: + - ROOT_ID + tabsInScope: + - TAB-d-E0Zc1cTH + - TAB-4fthLQmdX + targets: + - column: + name: quantity_ordered + datasetUuid: e8623bb9-5e00-f531-506a-19607f5f8005 + type: NATIVE_FILTER + - cascadeParentIds: [] + chartsInScope: + - 111 + - 112 + - 113 + - 114 + - 115 + - 116 + - 117 + - 118 + - 119 + - 120 + controlValues: + enableEmptyFilter: false + defaultDataMask: + extraFormData: {} + filterState: {} + ownState: {} + description: '' + filterType: filter_time + id: NATIVE_FILTER-V_UJOthxN8gCeYSD0id9b + name: Time Range + scope: + excluded: [] + rootPath: + - ROOT_ID + tabsInScope: + - TAB-d-E0Zc1cTH + - TAB-4fthLQmdX + targets: + - {} + type: NATIVE_FILTER + - cascadeParentIds: [] + chartsInScope: + - 111 + - 112 + - 113 + - 114 + - 115 + - 116 + - 117 + - 118 + - 119 + - 120 + controlValues: + enableEmptyFilter: false + defaultDataMask: + extraFormData: {} + filterState: {} + ownState: {} + description: '' + filterType: filter_timegrain + id: NATIVE_FILTER-t8xOh3el1KBWWiCIF5hIN + name: Time Grain + scope: + excluded: [] + rootPath: + - ROOT_ID + tabsInScope: + - TAB-d-E0Zc1cTH + - TAB-4fthLQmdX + targets: + - datasetUuid: e8623bb9-5e00-f531-506a-19607f5f8005 + type: NATIVE_FILTER + - cascadeParentIds: [] + chartsInScope: + - 111 + - 112 + - 113 + - 114 + - 115 + - 116 + - 117 + - 118 + - 119 + - 120 + controlValues: + defaultToFirstItem: false + enableEmptyFilter: false + inverseSelection: false + multiSelect: true + searchAllOptions: false + defaultDataMask: + extraFormData: {} + filterState: {} + ownState: {} + description: '' + filterType: filter_select + id: NATIVE_FILTER-9tGcTjqhNxOgX2AEPLVil + name: Postal Code + scope: + excluded: [] + rootPath: + - ROOT_ID + tabsInScope: + - TAB-d-E0Zc1cTH + - TAB-4fthLQmdX + targets: + - column: + name: postal_code + datasetUuid: e8623bb9-5e00-f531-506a-19607f5f8005 + type: NATIVE_FILTER + - cascadeParentIds: [] + chartsInScope: + - 111 + - 112 + - 113 + - 114 + - 115 + - 116 + - 117 + - 118 + - 119 + - 120 + controlValues: + defaultToFirstItem: false + enableEmptyFilter: false + inverseSelection: false + multiSelect: true + searchAllOptions: false + defaultDataMask: + extraFormData: {} + filterState: {} + ownState: {} + description: '' + filterType: filter_select + id: NATIVE_FILTER-pGnu5e_bg1IGz2wdzIuCA + name: State + scope: + excluded: [] + rootPath: + - ROOT_ID + tabsInScope: + - TAB-d-E0Zc1cTH + - TAB-4fthLQmdX + targets: + - column: + name: state + datasetUuid: e8623bb9-5e00-f531-506a-19607f5f8005 + type: NATIVE_FILTER + - cascadeParentIds: [] + chartsInScope: + - 111 + - 112 + - 113 + - 114 + - 115 + - 116 + - 117 + - 118 + - 119 + - 120 + controlValues: + enableEmptyFilter: false + defaultDataMask: + extraFormData: {} + filterState: {} + ownState: {} + description: '' + filterType: filter_range + id: NATIVE_FILTER-EVb_e9pndL9UByuZt0z_w + name: MSRP + scope: + excluded: [] + rootPath: + - ROOT_ID + tabsInScope: + - TAB-d-E0Zc1cTH + - TAB-4fthLQmdX + targets: + - column: + name: msrp + datasetUuid: e8623bb9-5e00-f531-506a-19607f5f8005 + type: NATIVE_FILTER + refresh_frequency: 0 + shared_label_colors: + - Classic Cars + - Motorcycles + - Planes + - Ships + - Trains + - Trucks and Buses + - Vintage Cars + timed_refresh_immune_slices: [] position: CHART-1NOOLm5YPs: children: [] id: CHART-1NOOLm5YPs meta: - chartId: 115 + chartId: 41 height: 25 sliceName: Items Sold sliceNameOverride: Total Products Sold @@ -44,7 +444,7 @@ position: children: [] id: CHART-AYpv8gFi_q meta: - chartId: 112 + chartId: 42 height: 70 sliceName: Number of Deals (for each Combination) uuid: bd20fc69-dd51-46c1-99b5-09e37a434bf1 @@ -59,7 +459,7 @@ position: children: [] id: CHART-KKT9BsnUst meta: - chartId: 113 + chartId: 45 height: 50 sliceName: Quarterly Sales (By Product Line) sliceNameOverride: Quarterly Revenue (By Product Line) @@ -75,7 +475,7 @@ position: children: [] id: CHART-OJ9aWDmn1q meta: - chartId: 116 + chartId: 46 height: 70 sliceName: Proportion of Revenue by Product Line sliceNameOverride: Proportion of Monthly Revenue by Product Line @@ -91,7 +491,7 @@ position: children: [] id: CHART-YFg-9wHE7s meta: - chartId: 119 + chartId: 47 height: 49 sliceName: Seasonality of Revenue (per Product Line) uuid: cf0da099-b3ab-4d94-ab62-cf353ac3c611 @@ -106,7 +506,7 @@ position: children: [] id: CHART-_LMKI0D3tj meta: - chartId: 117 + chartId: 44 height: 49 sliceName: Revenue by Deal Size sliceNameOverride: Monthly Revenue by Deal SIze @@ -122,7 +522,7 @@ position: children: [] id: CHART-id4RGv80N- meta: - chartId: 111 + chartId: 40 height: 50 sliceName: Items by Product Line sliceNameOverride: Products Sold By Product Line @@ -139,7 +539,7 @@ position: children: [] id: CHART-j24u8ve41b meta: - chartId: 120 + chartId: 43 height: 50 sliceName: Overall Sales (By Product Line) sliceNameOverride: Total Revenue By Product @@ -155,7 +555,7 @@ position: children: [] id: CHART-lFanAaYKBK meta: - chartId: 114 + chartId: 39 height: 26 sliceName: Total Revenue uuid: 7b12a243-88e0-4dc5-ac33-9a840bb0ac5a @@ -171,7 +571,7 @@ position: children: [] id: CHART-vomBOiI7U9 meta: - chartId: 118 + chartId: 48 height: 53 sliceName: Quarterly Sales sliceNameOverride: Quarterly Revenue @@ -226,15 +626,39 @@ position: children: [] id: MARKDOWN--AtDSWnapE meta: - code: "# \U0001F697 Vehicle Sales \U0001F3CD\n\nThis example dashboard provides\ - \ insight into the business operations of vehicle seller. The dataset powering\ - \ this dashboard can be found [here on Kaggle](https://www.kaggle.com/kyanyoga/sample-sales-data).\n\ - \n### Timeline\n\nThe dataset contains data on all orders from the 2003 and\ - \ 2004 fiscal years, and some orders from 2005.\n\n### Products Sold\n\nThis\ - \ shop mainly sells the following products:\n\n- \U0001F697 Classic Cars\n\ - - \U0001F3CE\uFE0F Vintage Cars\n- \U0001F3CD\uFE0F Motorcycles\n- \U0001F69A\ - \ Trucks & Buses \U0001F68C\n- \U0001F6E9\uFE0F Planes\n- \U0001F6A2 Ships\n\ - - \U0001F688 Trains" + code: '# 🚗 Vehicle Sales 🏍 + + + This example dashboard provides insight into the business operations of vehicle + seller. The dataset powering this dashboard can be found [here on Kaggle](https://www.kaggle.com/kyanyoga/sample-sales-data). + + + ### Timeline + + + The dataset contains data on all orders from the 2003 and 2004 fiscal years, + and some orders from 2005. + + + ### Products Sold + + + This shop mainly sells the following products: + + + - 🚗 Classic Cars + + - 🏎️ Vintage Cars + + - 🏍️ Motorcycles + + - 🚚 Trucks & Buses 🚌 + + - 🛩️ Planes + + - 🚢 Ships + + - 🚈 Trains' height: 53 width: 3 parents: @@ -304,7 +728,7 @@ position: - ROW-E7MDSGfnm id: TAB-4fthLQmdX meta: - text: "\U0001F9ED Exploratory" + text: 🧭 Exploratory parents: - ROOT_ID - TABS-e5Ruro0cjP @@ -315,7 +739,7 @@ position: - ROW-oAtmu5grZ id: TAB-d-E0Zc1cTH meta: - text: "\U0001F3AF Sales Overview" + text: 🎯 Sales Overview parents: - ROOT_ID - TABS-e5Ruro0cjP @@ -329,407 +753,7 @@ position: parents: - ROOT_ID type: TABS -metadata: - timed_refresh_immune_slices: [] - expanded_slices: {} - refresh_frequency: 0 - default_filters: '{}' - color_scheme: supersetColors - label_colors: - Medium: '#1FA8C9' - Small: '#454E7C' - Large: '#5AC189' - SUM(SALES): '#1FA8C9' - Classic Cars: '#454E7C' - Vintage Cars: '#5AC189' - Motorcycles: '#FF7F44' - Trucks and Buses: '#666666' - Planes: '#E04355' - Ships: '#FCC700' - Trains: '#A868B7' - native_filter_configuration: - - id: NATIVE_FILTER-HX2lV--YaAZRQfJ_yfYB2 - controlValues: - enableEmptyFilter: false - defaultToFirstItem: false - multiSelect: true - searchAllOptions: false - inverseSelection: false - name: Country - filterType: filter_select - targets: - - column: - name: country - datasetUuid: e8623bb9-5e00-f531-506a-19607f5f8005 - defaultDataMask: - extraFormData: {} - filterState: {} - ownState: {} - cascadeParentIds: [] - scope: - rootPath: - - ROOT_ID - excluded: [] - type: NATIVE_FILTER - description: '' - chartsInScope: - - 111 - - 112 - - 113 - - 114 - - 115 - - 116 - - 117 - - 118 - - 119 - - 120 - tabsInScope: - - TAB-d-E0Zc1cTH - - TAB-4fthLQmdX - - id: NATIVE_FILTER-oCF7UtoHuDIBg44q5peth - controlValues: - enableEmptyFilter: false - name: Order Quantity - filterType: filter_range - targets: - - column: - name: quantity_ordered - datasetUuid: e8623bb9-5e00-f531-506a-19607f5f8005 - defaultDataMask: - extraFormData: {} - filterState: {} - ownState: {} - cascadeParentIds: [] - scope: - rootPath: - - ROOT_ID - excluded: [] - type: NATIVE_FILTER - description: '' - chartsInScope: - - 111 - - 112 - - 113 - - 114 - - 115 - - 116 - - 117 - - 118 - - 119 - - 120 - tabsInScope: - - TAB-d-E0Zc1cTH - - TAB-4fthLQmdX - - id: NATIVE_FILTER-V_UJOthxN8gCeYSD0id9b - controlValues: - enableEmptyFilter: false - name: Time Range - filterType: filter_time - targets: - - {} - defaultDataMask: - extraFormData: {} - filterState: {} - ownState: {} - cascadeParentIds: [] - scope: - rootPath: - - ROOT_ID - excluded: [] - type: NATIVE_FILTER - description: '' - chartsInScope: - - 111 - - 112 - - 113 - - 114 - - 115 - - 116 - - 117 - - 118 - - 119 - - 120 - tabsInScope: - - TAB-d-E0Zc1cTH - - TAB-4fthLQmdX - - id: NATIVE_FILTER-t8xOh3el1KBWWiCIF5hIN - controlValues: - enableEmptyFilter: false - name: Time Grain - filterType: filter_timegrain - targets: - - datasetUuid: e8623bb9-5e00-f531-506a-19607f5f8005 - defaultDataMask: - extraFormData: {} - filterState: {} - ownState: {} - cascadeParentIds: [] - scope: - excluded: [] - rootPath: - - ROOT_ID - type: NATIVE_FILTER - description: '' - chartsInScope: - - 111 - - 112 - - 113 - - 114 - - 115 - - 116 - - 117 - - 118 - - 119 - - 120 - tabsInScope: - - TAB-d-E0Zc1cTH - - TAB-4fthLQmdX - - id: NATIVE_FILTER-9tGcTjqhNxOgX2AEPLVil - controlValues: - enableEmptyFilter: false - defaultToFirstItem: false - multiSelect: true - searchAllOptions: false - inverseSelection: false - name: Postal Code - filterType: filter_select - targets: - - column: - name: postal_code - datasetUuid: e8623bb9-5e00-f531-506a-19607f5f8005 - defaultDataMask: - extraFormData: {} - filterState: {} - ownState: {} - cascadeParentIds: [] - scope: - rootPath: - - ROOT_ID - excluded: [] - type: NATIVE_FILTER - description: '' - chartsInScope: - - 111 - - 112 - - 113 - - 114 - - 115 - - 116 - - 117 - - 118 - - 119 - - 120 - tabsInScope: - - TAB-d-E0Zc1cTH - - TAB-4fthLQmdX - - id: NATIVE_FILTER-pGnu5e_bg1IGz2wdzIuCA - controlValues: - enableEmptyFilter: false - defaultToFirstItem: false - multiSelect: true - searchAllOptions: false - inverseSelection: false - name: State - filterType: filter_select - targets: - - column: - name: state - datasetUuid: e8623bb9-5e00-f531-506a-19607f5f8005 - defaultDataMask: - extraFormData: {} - filterState: {} - ownState: {} - cascadeParentIds: [] - scope: - rootPath: - - ROOT_ID - excluded: [] - type: NATIVE_FILTER - description: '' - chartsInScope: - - 111 - - 112 - - 113 - - 114 - - 115 - - 116 - - 117 - - 118 - - 119 - - 120 - tabsInScope: - - TAB-d-E0Zc1cTH - - TAB-4fthLQmdX - - id: NATIVE_FILTER-EVb_e9pndL9UByuZt0z_w - controlValues: - enableEmptyFilter: false - name: MSRP - filterType: filter_range - targets: - - column: - name: msrp - datasetUuid: e8623bb9-5e00-f531-506a-19607f5f8005 - defaultDataMask: - extraFormData: {} - filterState: {} - ownState: {} - cascadeParentIds: [] - scope: - rootPath: - - ROOT_ID - excluded: [] - type: NATIVE_FILTER - description: '' - chartsInScope: - - 111 - - 112 - - 113 - - 114 - - 115 - - 116 - - 117 - - 118 - - 119 - - 120 - tabsInScope: - - TAB-d-E0Zc1cTH - - TAB-4fthLQmdX - shared_label_colors: - - Classic Cars - - Motorcycles - - Planes - - Ships - - Trains - - Trucks and Buses - - Vintage Cars - map_label_colors: - Shipped: '#1FA8C9' - Cancelled: '#454E7C' - On Hold: '#5AC189' - Resolved: '#FF7F44' - In Process: '#666666' - Disputed: '#E04355' - color_scheme_domain: - - '#1FA8C9' - - '#454E7C' - - '#5AC189' - - '#FF7F44' - - '#666666' - - '#E04355' - - '#FCC700' - - '#A868B7' - - '#3CCCCB' - - '#A38F79' - - '#8FD3E4' - - '#A1A6BD' - - '#ACE1C4' - - '#FEC0A1' - - '#B2B2B2' - - '#EFA1AA' - - '#FDE380' - - '#D3B3DA' - - '#9EE5E5' - - '#D1C6BC' - cross_filters_enabled: true - chart_configuration: - '111': - id: 111 - crossFilters: - scope: global - chartsInScope: - - 112 - - 113 - - 114 - - 115 - - 116 - - 117 - - 118 - - 119 - - 120 - '113': - id: 113 - crossFilters: - scope: global - chartsInScope: - - 111 - - 112 - - 114 - - 115 - - 116 - - 117 - - 118 - - 119 - - 120 - '116': - id: 116 - crossFilters: - scope: global - chartsInScope: - - 111 - - 112 - - 113 - - 114 - - 115 - - 117 - - 118 - - 119 - - 120 - '117': - id: 117 - crossFilters: - scope: global - chartsInScope: - - 111 - - 112 - - 113 - - 114 - - 115 - - 116 - - 118 - - 119 - - 120 - '118': - id: 118 - crossFilters: - scope: global - chartsInScope: - - 111 - - 112 - - 113 - - 114 - - 115 - - 116 - - 117 - - 119 - - 120 - '120': - id: 120 - crossFilters: - scope: global - chartsInScope: - - 111 - - 112 - - 113 - - 114 - - 115 - - 116 - - 117 - - 118 - - 119 - global_chart_configuration: - scope: - rootPath: - - ROOT_ID - excluded: [] - chartsInScope: - - 111 - - 112 - - 113 - - 114 - - 115 - - 116 - - 117 - - 118 - - 119 - - 120 +published: true +slug: null +uuid: 04f79081-fb49-7bac-7f14-cc76cd2ad93b version: 1.0.0 diff --git a/superset/examples/sales_dashboard/data.parquet b/superset/examples/sales_dashboard/data.parquet new file mode 100644 index 00000000000..1b50e80b669 Binary files /dev/null and b/superset/examples/sales_dashboard/data.parquet differ diff --git a/superset/examples/configs/datasets/examples/channels.yaml b/superset/examples/sales_dashboard/dataset.yaml similarity index 67% rename from superset/examples/configs/datasets/examples/channels.yaml rename to superset/examples/sales_dashboard/dataset.yaml index bc1dad46ba5..37b6f114673 100644 --- a/superset/examples/configs/datasets/examples/channels.yaml +++ b/superset/examples/sales_dashboard/dataset.yaml @@ -14,350 +14,335 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -table_name: channels -main_dttm_col: created -description: null -default_endpoint: null -offset: 0 +always_filter_main_dttm: false cache_timeout: null +catalog: null +columns: +- advanced_data_type: null + column_name: order_date + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: true + python_date_format: null + type: TIMESTAMP WITHOUT TIME ZONE + verbose_name: null +- advanced_data_type: null + column_name: price_each + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: sales + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null +- advanced_data_type: null + column_name: address_line1 + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: address_line2 + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: order_line_number + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: quantity_ordered + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: order_number + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: quarter + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: year + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: month + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: msrp + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: contact_last_name + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: contact_first_name + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: postal_code + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: customer_name + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: deal_size + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: product_code + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: product_line + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: state + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: status + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: city + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: country + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: phone + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: territory + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +data_file: data.parquet +database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee +default_endpoint: null +description: null +extra: null +fetch_values_predicate: null +filter_select_enabled: true +folders: null +main_dttm_col: order_date +metrics: +- currency: null + d3format: null + description: null + expression: COUNT(*) + extra: null + metric_name: count + metric_type: count + verbose_name: COUNT(*) + warning_text: null +normalize_columns: false +offset: 0 +params: null schema: null sql: null -params: null +table_name: cleaned_sales_data template_params: null -filter_select_enabled: true -fetch_values_predicate: null -extra: null -uuid: f7db6d45-7056-f395-d24a-6c805fb4c97d -metrics: -- metric_name: count - verbose_name: COUNT(*) - metric_type: count - expression: COUNT(*) - description: null - d3format: null - extra: null - warning_text: null -columns: -- column_name: topic__last_set - verbose_name: null - is_dttm: true - is_active: true - type: TIMESTAMP WITHOUT TIME ZONE - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: purpose__last_set - verbose_name: null - is_dttm: true - is_active: true - type: TIMESTAMP WITHOUT TIME ZONE - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: created - verbose_name: null - is_dttm: true - is_active: true - type: TIMESTAMP WITHOUT TIME ZONE - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: unlinked - verbose_name: null - is_dttm: true - is_active: true - type: TIMESTAMP WITHOUT TIME ZONE - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: topic__creator - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: purpose__creator - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: topic__value - verbose_name: null - is_dttm: false - is_active: true - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: purpose__value - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: parent_conversation - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: name_normalized - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: channel_id - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: creator - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: name - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: id - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: is_pending_ext_shared - verbose_name: null - is_dttm: false - is_active: true - type: BOOLEAN - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: is_ext_shared - verbose_name: null - is_dttm: false - is_active: true - type: BOOLEAN - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: is_org_shared - verbose_name: null - is_dttm: false - is_active: true - type: BOOLEAN - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: is_archived - verbose_name: null - is_dttm: false - is_active: true - type: BOOLEAN - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: is_channel - verbose_name: null - is_dttm: false - is_active: true - type: BOOLEAN - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: is_shared - verbose_name: null - is_dttm: false - is_active: true - type: BOOLEAN - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: is_general - verbose_name: null - is_dttm: false - is_active: true - type: BOOLEAN - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: is_private - verbose_name: null - is_dttm: false - is_active: true - type: BOOLEAN - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: is_member - verbose_name: null - is_dttm: false - is_active: true - type: BOOLEAN - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: is_group - verbose_name: null - is_dttm: false - is_active: true - type: BOOLEAN - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: is_mpim - verbose_name: null - is_dttm: false - is_active: true - type: BOOLEAN - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: is_im - verbose_name: null - is_dttm: false - is_active: true - type: BOOLEAN - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: num_members - verbose_name: null - is_dttm: false - is_active: true - type: BIGINT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: pending_connected_team_ids - verbose_name: null - is_dttm: false - is_active: true - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: shared_team_ids - verbose_name: null - is_dttm: false - is_active: true - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: pending_shared - verbose_name: null - is_dttm: false - is_active: true - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: previous_names - verbose_name: null - is_dttm: false - is_active: true - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: members - verbose_name: null - is_dttm: false - is_active: true - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null +uuid: e8623bb9-5e00-f531-506a-19607f5f8005 version: 1.0.0 -database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee -data: examples://datasets/examples/slack/channels.csv diff --git a/superset/examples/sf_population_polygons.py b/superset/examples/sf_population_polygons.py deleted file mode 100644 index de4c391e79c..00000000000 --- a/superset/examples/sf_population_polygons.py +++ /dev/null @@ -1,71 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. - -import logging - -from sqlalchemy import BigInteger, Float, inspect, Text - -import superset.utils.database as database_utils -from superset import db -from superset.sql.parse import Table -from superset.utils import json - -from .helpers import get_table_connector_registry, read_example_data - -logger = logging.getLogger(__name__) - - -def load_sf_population_polygons( - only_metadata: bool = False, force: bool = False -) -> None: - tbl_name = "sf_population_polygons" - database = database_utils.get_example_database() - with database.get_sqla_engine() as engine: - schema = inspect(engine).default_schema_name - table_exists = database.has_table(Table(tbl_name, schema)) - - if not only_metadata and (not table_exists or force): - df = read_example_data( - "examples://sf_population.json.gz", compression="gzip" - ) - df["contour"] = df.contour.map(json.dumps) - - df.to_sql( - tbl_name, - engine, - schema=schema, - if_exists="replace", - chunksize=500, - dtype={ - "zipcode": BigInteger, - "population": BigInteger, - "contour": Text, - "area": Float, - }, - index=False, - ) - - logger.debug("Creating table %s reference", tbl_name) - table = get_table_connector_registry() - tbl = db.session.query(table).filter_by(table_name=tbl_name).first() - if not tbl: - tbl = table(table_name=tbl_name, schema=schema) - db.session.add(tbl) - tbl.description = "Population density of San Francisco" - tbl.database = database - tbl.filter_select_enabled = True - tbl.fetch_metadata() diff --git a/superset/examples/configs/charts/Slack Dashboard/Cross_Channel_Relationship.yaml b/superset/examples/slack_dashboard/charts/Cross_Channel_Relationship.yaml similarity index 94% rename from superset/examples/configs/charts/Slack Dashboard/Cross_Channel_Relationship.yaml rename to superset/examples/slack_dashboard/charts/Cross_Channel_Relationship.yaml index dc60805bf0b..65bd7a215a1 100644 --- a/superset/examples/configs/charts/Slack Dashboard/Cross_Channel_Relationship.yaml +++ b/superset/examples/slack_dashboard/charts/Cross_Channel_Relationship.yaml @@ -14,10 +14,14 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Cross Channel Relationship -viz_type: chord +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 473d6113-b44a-48d8-a6ae-e0ef7e2aebb0 +description: null params: adhoc_filters: [] + annotation_layers: [] color_scheme: supersetColors columns: channel_2 datasource: 59__table @@ -51,7 +55,8 @@ params: time_range: No filter viz_type: chord y_axis_format: SMART_NUMBER -cache_timeout: null +query_context: null +slice_name: Cross Channel Relationship uuid: f2a8731b-3d8c-4d86-9d33-7c0a3e64d21c version: 1.0.0 -dataset_uuid: 473d6113-b44a-48d8-a6ae-e0ef7e2aebb0 +viz_type: chord diff --git a/superset/examples/configs/charts/Slack Dashboard/Cross_Channel_Relationship_heatmap_2786.yaml b/superset/examples/slack_dashboard/charts/Cross_Channel_Relationship_heatmap_v2.yaml similarity index 93% rename from superset/examples/configs/charts/Slack Dashboard/Cross_Channel_Relationship_heatmap_2786.yaml rename to superset/examples/slack_dashboard/charts/Cross_Channel_Relationship_heatmap_v2.yaml index f06924f37db..76562a4017a 100644 --- a/superset/examples/configs/charts/Slack Dashboard/Cross_Channel_Relationship_heatmap_2786.yaml +++ b/superset/examples/slack_dashboard/charts/Cross_Channel_Relationship_heatmap_v2.yaml @@ -14,14 +14,17 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Cross Channel Relationship heatmap_v2 -viz_type: heatmap_v2 +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 473d6113-b44a-48d8-a6ae-e0ef7e2aebb0 +description: null params: adhoc_filters: [] - x_axis: channel_1 - groupby: channel_2 + annotation_layers: [] bottom_margin: auto datasource: 35__table + groupby: channel_2 left_margin: auto linear_color_scheme: schemeBlues metric: @@ -53,14 +56,16 @@ params: sort_y_axis: alpha_asc time_range: No filter url_params: {} - viz_type: heatmap_v2 - xscale_interval: null value_bounds: - - null - - null + - null + - null + viz_type: heatmap_v2 + x_axis: channel_1 + xscale_interval: null y_axis_format: SMART_NUMBER yscale_interval: null -cache_timeout: null +query_context: null +slice_name: Cross Channel Relationship heatmap_v2 uuid: 6cb43397-5c62-4f32-bde2-95344c412b5a version: 1.0.0 -dataset_uuid: 473d6113-b44a-48d8-a6ae-e0ef7e2aebb0 +viz_type: heatmap_v2 diff --git a/superset/examples/configs/charts/Slack Dashboard/Members_per_Channel.yaml b/superset/examples/slack_dashboard/charts/Members_per_Channel.yaml similarity index 91% rename from superset/examples/configs/charts/Slack Dashboard/Members_per_Channel.yaml rename to superset/examples/slack_dashboard/charts/Members_per_Channel.yaml index eb247d48663..56512e76c93 100644 --- a/superset/examples/configs/charts/Slack Dashboard/Members_per_Channel.yaml +++ b/superset/examples/slack_dashboard/charts/Members_per_Channel.yaml @@ -14,14 +14,18 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Members per Channel -viz_type: treemap_v2 +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 3d9c0054-b31b-4102-92de-b1ef9f9e5e77 +description: null params: adhoc_filters: [] + annotation_layers: [] color_scheme: supersetColors datasource: 57__table groupby: - - channel_name + - channel_name label_colors: {} metric: count number_format: SMART_NUMBER @@ -34,7 +38,8 @@ params: treemap_ratio: 1.618033988749895 url_params: {} viz_type: treemap_v2 -cache_timeout: null +query_context: null +slice_name: Members per Channel uuid: d44e416d-1647-44e4-b442-6da34b44adc4 version: 1.0.0 -dataset_uuid: 3d9c0054-b31b-4102-92de-b1ef9f9e5e77 +viz_type: treemap_v2 diff --git a/superset/examples/configs/charts/Slack Dashboard/Messages_per_Channel.yaml b/superset/examples/slack_dashboard/charts/Messages_per_Channel.yaml similarity index 57% rename from superset/examples/configs/charts/Slack Dashboard/Messages_per_Channel.yaml rename to superset/examples/slack_dashboard/charts/Messages_per_Channel.yaml index a1c5e33c021..bbf2eaa105d 100644 --- a/superset/examples/configs/charts/Slack Dashboard/Messages_per_Channel.yaml +++ b/superset/examples/slack_dashboard/charts/Messages_per_Channel.yaml @@ -14,19 +14,22 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Messages per Channel -viz_type: echarts_area +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 6e533506-fce6-4f6a-b116-d139df6dbdea +description: null params: adhoc_filters: - - clause: WHERE - comparator: github-notifications - expressionType: SIMPLE - filterOptionName: filter_7ud3u2eujnw_1pmeehxvw0b - isExtra: false - isNew: false - operator: "!=" - sqlExpression: null - subject: name + - clause: WHERE + comparator: github-notifications + expressionType: SIMPLE + filterOptionName: filter_7ud3u2eujnw_1pmeehxvw0b + isExtra: false + isNew: false + operator: '!=' + sqlExpression: null + subject: name annotation_layers: [] bottom_margin: auto color_scheme: supersetColors @@ -34,44 +37,44 @@ params: datasource: 56__table granularity_sqla: ts groupby: - - name + - name label_colors: - "0": "#1FA8C9" - "1": "#454E7C" - announcements: "#A868B7" - apache-releases: "#666666" - beginners: "#666666" - commits: "#E04355" - community-feedback: "#EFA1AA" - contributing: "#8FD3E4" - cypress-tests: "#FDE380" - dashboard-filters: "#FCC700" - dashboard-level-access: "#D1C6BC" - dashboards: "#3CCCCB" - design: "#1FA8C9" - developers: "#9EE5E5" - embedded-dashboards: "#ACE1C4" - feature-requests: "#454E7C" - general: "#3CCCCB" - github-notifications: "#E04355" - globalnav_search: "#A1A6BD" - graduation: "#A1A6BD" - helm-k8-deployment: "#FEC0A1" - introductions: "#5AC189" - jobs: "#FF7F44" - localization: "#5AC189" - newsletter: "#FF7F44" - product_feedback: "#D3B3DA" - pull-requests: "#A38F79" - superset-champions: "#FCC700" - superset_prod_reports: "#A868B7" - superset_stage_alerts: "#A38F79" - support: "#8FD3E4" - visualization_plugins: "#B2B2B2" + '0': '#1FA8C9' + '1': '#454E7C' + announcements: '#A868B7' + apache-releases: '#666666' + beginners: '#666666' + commits: '#E04355' + community-feedback: '#EFA1AA' + contributing: '#8FD3E4' + cypress-tests: '#FDE380' + dashboard-filters: '#FCC700' + dashboard-level-access: '#D1C6BC' + dashboards: '#3CCCCB' + design: '#1FA8C9' + developers: '#9EE5E5' + embedded-dashboards: '#ACE1C4' + feature-requests: '#454E7C' + general: '#3CCCCB' + github-notifications: '#E04355' + globalnav_search: '#A1A6BD' + graduation: '#A1A6BD' + helm-k8-deployment: '#FEC0A1' + introductions: '#5AC189' + jobs: '#FF7F44' + localization: '#5AC189' + newsletter: '#FF7F44' + product_feedback: '#D3B3DA' + pull-requests: '#A38F79' + superset-champions: '#FCC700' + superset_prod_reports: '#A868B7' + superset_stage_alerts: '#A38F79' + support: '#8FD3E4' + visualization_plugins: '#B2B2B2' limit: 10 line_interpolation: linear metrics: - - count + - count min_periods: 0 order_desc: true queryFields: @@ -94,11 +97,12 @@ params: x_axis_showminmax: true x_ticks_layout: auto y_axis_bounds: - - 0 - - null + - 0 + - null y_axis_format: SMART_NUMBER y_log_scale: false -cache_timeout: null +query_context: null +slice_name: Messages per Channel uuid: b0f11bdf-793f-473f-b7d5-b9265e657896 version: 1.0.0 -dataset_uuid: 6e533506-fce6-4f6a-b116-d139df6dbdea +viz_type: echarts_area diff --git a/superset/examples/configs/charts/Slack Dashboard/New_Members_per_Month.yaml b/superset/examples/slack_dashboard/charts/New_Members_per_Month.yaml similarity index 94% rename from superset/examples/configs/charts/Slack Dashboard/New_Members_per_Month.yaml rename to superset/examples/slack_dashboard/charts/New_Members_per_Month.yaml index 84f432a3062..5c08cec1733 100644 --- a/superset/examples/configs/charts/Slack Dashboard/New_Members_per_Month.yaml +++ b/superset/examples/slack_dashboard/charts/New_Members_per_Month.yaml @@ -14,10 +14,14 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: New Members per Month -viz_type: big_number +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 9dd99cda-ff6b-4575-9a74-684d06e871ab +description: null params: adhoc_filters: [] + annotation_layers: [] color_picker: a: 1 b: 135 @@ -60,7 +64,8 @@ params: url_params: {} viz_type: big_number y_axis_format: SMART_NUMBER -cache_timeout: null +query_context: null +slice_name: New Members per Month uuid: 92e1d712-bcf9-4d7e-9b94-26cffe502908 version: 1.0.0 -dataset_uuid: 9dd99cda-ff6b-4575-9a74-684d06e871ab +viz_type: big_number diff --git a/superset/examples/configs/charts/Slack Dashboard/Number_of_Members.yaml b/superset/examples/slack_dashboard/charts/Number_of_Members.yaml similarity index 92% rename from superset/examples/configs/charts/Slack Dashboard/Number_of_Members.yaml rename to superset/examples/slack_dashboard/charts/Number_of_Members.yaml index 35eba32b618..41cf421f31e 100644 --- a/superset/examples/configs/charts/Slack Dashboard/Number_of_Members.yaml +++ b/superset/examples/slack_dashboard/charts/Number_of_Members.yaml @@ -14,10 +14,14 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Number of Members -viz_type: big_number_total +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 7195db6b-2d17-7619-b7c7-26b15378df8c +description: null params: adhoc_filters: [] + annotation_layers: [] datasource: 31__table granularity_sqla: updated header_font_size: 0.4 @@ -30,7 +34,8 @@ params: url_params: {} viz_type: big_number_total y_axis_format: SMART_NUMBER -cache_timeout: null +query_context: null +slice_name: Number of Members uuid: 7dad983b-e9f6-d2e8-91da-c2262d4e84e8 version: 1.0.0 -dataset_uuid: 7195db6b-2d17-7619-b7c7-26b15378df8c +viz_type: big_number_total diff --git a/superset/examples/configs/charts/Slack Dashboard/Top_Timezones.yaml b/superset/examples/slack_dashboard/charts/Top_Timezones.yaml similarity index 93% rename from superset/examples/configs/charts/Slack Dashboard/Top_Timezones.yaml rename to superset/examples/slack_dashboard/charts/Top_Timezones.yaml index 3879c4a193b..07b4eab5757 100644 --- a/superset/examples/configs/charts/Slack Dashboard/Top_Timezones.yaml +++ b/superset/examples/slack_dashboard/charts/Top_Timezones.yaml @@ -14,12 +14,16 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Top Timezones -viz_type: table +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 7195db6b-2d17-7619-b7c7-26b15378df8c +description: null params: adhoc_filters: [] align_pn: false all_columns: [] + annotation_layers: [] color_pn: true datasource: 31__table granularity_sqla: updated @@ -44,7 +48,8 @@ params: time_range: No filter url_params: {} viz_type: table -cache_timeout: null +query_context: null +slice_name: Top Timezones uuid: 62b7242e-decc-2d1b-7f80-c62776939d1e version: 1.0.0 -dataset_uuid: 7195db6b-2d17-7619-b7c7-26b15378df8c +viz_type: table diff --git a/superset/examples/configs/charts/Slack Dashboard/Weekly_Messages.yaml b/superset/examples/slack_dashboard/charts/Weekly_Messages.yaml similarity index 93% rename from superset/examples/configs/charts/Slack Dashboard/Weekly_Messages.yaml rename to superset/examples/slack_dashboard/charts/Weekly_Messages.yaml index 1f8cfc908fa..3917a51925e 100644 --- a/superset/examples/configs/charts/Slack Dashboard/Weekly_Messages.yaml +++ b/superset/examples/slack_dashboard/charts/Weekly_Messages.yaml @@ -14,10 +14,14 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Weekly Messages -viz_type: big_number +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: e032c69e-716e-d700-eff7-07800d0f9989 +description: null params: adhoc_filters: [] + annotation_layers: [] color_picker: a: 1 b: 135 @@ -42,7 +46,8 @@ params: url_params: {} viz_type: big_number y_axis_format: SMART_NUMBER -cache_timeout: null +query_context: null +slice_name: Weekly Messages uuid: abe2c022-ceee-a60a-e601-ab93f7ee52b1 version: 1.0.0 -dataset_uuid: e032c69e-716e-d700-eff7-07800d0f9989 +viz_type: big_number diff --git a/superset/examples/configs/charts/Slack Dashboard/Weekly_Threads.yaml b/superset/examples/slack_dashboard/charts/Weekly_Threads.yaml similarity index 93% rename from superset/examples/configs/charts/Slack Dashboard/Weekly_Threads.yaml rename to superset/examples/slack_dashboard/charts/Weekly_Threads.yaml index c875f8e184c..2ce3f724e6a 100644 --- a/superset/examples/configs/charts/Slack Dashboard/Weekly_Threads.yaml +++ b/superset/examples/slack_dashboard/charts/Weekly_Threads.yaml @@ -14,10 +14,14 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Weekly Threads -viz_type: big_number +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: d7438be6-6078-17dd-cf9a-56f0ef546c80 +description: null params: adhoc_filters: [] + annotation_layers: [] color_picker: a: 1 b: 135 @@ -41,7 +45,8 @@ params: url_params: {} viz_type: big_number y_axis_format: SMART_NUMBER -cache_timeout: null +query_context: null +slice_name: Weekly Threads uuid: 9f742bdd-cac1-468c-3a37-35c9b3cfd5bb version: 1.0.0 -dataset_uuid: d7438be6-6078-17dd-cf9a-56f0ef546c80 +viz_type: big_number diff --git a/superset/examples/configs/dashboards/Slack_Dashboard.yaml b/superset/examples/slack_dashboard/dashboard.yaml similarity index 62% rename from superset/examples/configs/dashboards/Slack_Dashboard.yaml rename to superset/examples/slack_dashboard/dashboard.yaml index c6f9d99be4c..46f01e73c22 100644 --- a/superset/examples/configs/dashboards/Slack_Dashboard.yaml +++ b/superset/examples/slack_dashboard/dashboard.yaml @@ -14,162 +14,208 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. +certification_details: null +certified_by: null +css: null dashboard_title: Slack Dashboard description: null -css: null -slug: null -uuid: 9726d8b0-222f-eb2c-034a-02b9f51ef5fd +metadata: + chart_configuration: {} + color_scheme: supersetColors + color_scheme_domain: [] + cross_filters_enabled: false + default_filters: '{}' + expanded_slices: {} + global_chart_configuration: {} + label_colors: + '0': '#1FA8C9' + '1': '#454E7C' + announcements: '#A868B7' + apache-releases: '#666666' + beginners: '#666666' + commits: '#E04355' + community-feedback: '#EFA1AA' + contributing: '#8FD3E4' + cypress-tests: '#FDE380' + dashboard-filters: '#FCC700' + dashboard-level-access: '#D1C6BC' + dashboards: '#3CCCCB' + design: '#1FA8C9' + developers: '#9EE5E5' + embedded-dashboards: '#ACE1C4' + feature-requests: '#454E7C' + general: '#3CCCCB' + github-notifications: '#E04355' + globalnav_search: '#A1A6BD' + graduation: '#A1A6BD' + helm-k8-deployment: '#FEC0A1' + introductions: '#5AC189' + jobs: '#FF7F44' + localization: '#5AC189' + newsletter: '#FF7F44' + product_feedback: '#D3B3DA' + pull-requests: '#A38F79' + superset-champions: '#FCC700' + superset_prod_reports: '#A868B7' + superset_stage_alerts: '#A38F79' + support: '#8FD3E4' + visualization_plugins: '#B2B2B2' + map_label_colors: {} + native_filter_configuration: [] + refresh_frequency: 0 + shared_label_colors: [] + timed_refresh_immune_slices: [] position: CHART-EYIBwyUiHc: children: [] id: CHART-EYIBwyUiHc meta: - chartId: 2396 + chartId: 117 height: 70 sliceName: Members per Channel uuid: d44e416d-1647-44e4-b442-6da34b44adc4 width: 3 parents: - - ROOT_ID - - GRID_ID - - ROW-PgcMF2PpB + - ROOT_ID + - GRID_ID + - ROW-PgcMF2PpB type: CHART CHART-FwpJA_o1-n: children: [] id: CHART-FwpJA_o1-n meta: - chartId: 3055 + chartId: 120 height: 44 sliceName: New Members per Month uuid: 92e1d712-bcf9-4d7e-9b94-26cffe502908 width: 2 parents: - - ROOT_ID - - GRID_ID - - ROW-aseZBdP1v + - ROOT_ID + - GRID_ID + - ROW-aseZBdP1v type: CHART CHART-JhE-Y0xxgi: children: [] id: CHART-JhE-Y0xxgi meta: - chartId: 1908 + chartId: 118 height: 44 sliceName: Top Timezones sliceNameOverride: Top Timezones for Members uuid: 62b7242e-decc-2d1b-7f80-c62776939d1e width: 4 parents: - - ROOT_ID - - GRID_ID - - ROW-aseZBdP1v + - ROOT_ID + - GRID_ID + - ROW-aseZBdP1v type: CHART CHART-RbxP2Dl7Ad: children: [] id: CHART-RbxP2Dl7Ad meta: - chartId: 1905 + chartId: 119 height: 44 sliceName: Weekly Messages uuid: abe2c022-ceee-a60a-e601-ab93f7ee52b1 width: 2 parents: - - ROOT_ID - - GRID_ID - - ROW-aseZBdP1v + - ROOT_ID + - GRID_ID + - ROW-aseZBdP1v type: CHART CHART-cj9KtCNRq3: children: [] id: CHART-cj9KtCNRq3 meta: - chartId: 1903 + chartId: 113 height: 19 sliceName: Number of Members uuid: 7dad983b-e9f6-d2e8-91da-c2262d4e84e8 width: 3 parents: - - ROOT_ID - - GRID_ID - - ROW-aseZBdP1v - - COLUMN-4bvhV9jxDI + - ROOT_ID + - GRID_ID + - ROW-aseZBdP1v + - COLUMN-4bvhV9jxDI type: CHART CHART-ej0FpkKxzj: children: [] id: CHART-ej0FpkKxzj meta: - chartId: 2398 + chartId: 114 height: 69 sliceName: Cross Channel Relationship uuid: 6cb43397-5c62-4f32-bde2-95344c412b5a width: 5 parents: - - ROOT_ID - - GRID_ID - - ROW-PgcMF2PpB + - ROOT_ID + - GRID_ID + - ROW-PgcMF2PpB type: CHART CHART-f42-kMWQPd: children: [] id: CHART-f42-kMWQPd meta: - chartId: 2397 + chartId: 115 height: 68 sliceName: Cross Channel Relationship uuid: f2a8731b-3d8c-4d86-9d33-7c0a3e64d21c width: 4 parents: - - ROOT_ID - - GRID_ID - - ROW-PgcMF2PpB + - ROOT_ID + - GRID_ID + - ROW-PgcMF2PpB type: CHART CHART-tMLHDtzb67: children: [] id: CHART-tMLHDtzb67 meta: - chartId: 2395 + chartId: 121 height: 85 sliceName: Messages per Channel uuid: b0f11bdf-793f-473f-b7d5-b9265e657896 width: 12 parents: - - ROOT_ID - - GRID_ID - - ROW-y62Rf2K3m + - ROOT_ID + - GRID_ID + - ROW-y62Rf2K3m type: CHART CHART-vIvrauAMxV: children: [] id: CHART-vIvrauAMxV meta: - chartId: 1906 + chartId: 116 height: 44 sliceName: Weekly Threads uuid: 9f742bdd-cac1-468c-3a37-35c9b3cfd5bb width: 2 parents: - - ROOT_ID - - GRID_ID - - ROW-aseZBdP1v + - ROOT_ID + - GRID_ID + - ROW-aseZBdP1v type: CHART COLUMN-4bvhV9jxDI: children: - - MARKDOWN--8u3tfVF49 - - CHART-cj9KtCNRq3 + - MARKDOWN--8u3tfVF49 + - CHART-cj9KtCNRq3 id: COLUMN-4bvhV9jxDI meta: background: BACKGROUND_TRANSPARENT width: 2 parents: - - ROOT_ID - - GRID_ID - - ROW-aseZBdP1v + - ROOT_ID + - GRID_ID + - ROW-aseZBdP1v type: COLUMN DASHBOARD_VERSION_KEY: v2 GRID_ID: children: - - ROW-aseZBdP1v - - ROW-y62Rf2K3m - - ROW-PgcMF2PpB + - ROW-aseZBdP1v + - ROW-y62Rf2K3m + - ROW-PgcMF2PpB id: GRID_ID parents: - - ROOT_ID + - ROOT_ID type: GRID HEADER_ID: id: HEADER_ID @@ -184,91 +230,55 @@ position: height: 23 width: 3 parents: - - ROOT_ID - - GRID_ID - - ROW-aseZBdP1v - - COLUMN-4bvhV9jxDI + - ROOT_ID + - GRID_ID + - ROW-aseZBdP1v + - COLUMN-4bvhV9jxDI type: MARKDOWN ROOT_ID: children: - - GRID_ID + - GRID_ID id: ROOT_ID type: ROOT ROW-PgcMF2PpB: children: - - CHART-EYIBwyUiHc - - CHART-f42-kMWQPd - - CHART-ej0FpkKxzj + - CHART-EYIBwyUiHc + - CHART-f42-kMWQPd + - CHART-ej0FpkKxzj id: ROW-PgcMF2PpB meta: - "0": ROOT_ID + '0': ROOT_ID background: BACKGROUND_TRANSPARENT parents: - - ROOT_ID - - GRID_ID + - ROOT_ID + - GRID_ID type: ROW ROW-aseZBdP1v: children: - - COLUMN-4bvhV9jxDI - - CHART-vIvrauAMxV - - CHART-RbxP2Dl7Ad - - CHART-FwpJA_o1-n - - CHART-JhE-Y0xxgi + - COLUMN-4bvhV9jxDI + - CHART-vIvrauAMxV + - CHART-RbxP2Dl7Ad + - CHART-FwpJA_o1-n + - CHART-JhE-Y0xxgi id: ROW-aseZBdP1v meta: background: BACKGROUND_TRANSPARENT parents: - - ROOT_ID - - GRID_ID + - ROOT_ID + - GRID_ID type: ROW ROW-y62Rf2K3m: children: - - CHART-tMLHDtzb67 + - CHART-tMLHDtzb67 id: ROW-y62Rf2K3m meta: - "0": ROOT_ID + '0': ROOT_ID background: BACKGROUND_TRANSPARENT parents: - - ROOT_ID - - GRID_ID + - ROOT_ID + - GRID_ID type: ROW -metadata: - timed_refresh_immune_slices: [] - expanded_slices: {} - refresh_frequency: 0 - default_filters: "{}" - color_scheme: supersetColors - label_colors: - "0": "#1FA8C9" - "1": "#454E7C" - introductions: "#5AC189" - jobs: "#FF7F44" - apache-releases: "#666666" - commits: "#E04355" - dashboard-filters: "#FCC700" - announcements: "#A868B7" - general: "#3CCCCB" - superset_stage_alerts: "#A38F79" - contributing: "#8FD3E4" - graduation: "#A1A6BD" - embedded-dashboards: "#ACE1C4" - helm-k8-deployment: "#FEC0A1" - visualization_plugins: "#B2B2B2" - community-feedback: "#EFA1AA" - cypress-tests: "#FDE380" - product_feedback: "#D3B3DA" - developers: "#9EE5E5" - dashboard-level-access: "#D1C6BC" - design: "#1FA8C9" - feature-requests: "#454E7C" - localization: "#5AC189" - newsletter: "#FF7F44" - beginners: "#666666" - github-notifications: "#E04355" - superset-champions: "#FCC700" - superset_prod_reports: "#A868B7" - dashboards: "#3CCCCB" - pull-requests: "#A38F79" - support: "#8FD3E4" - globalnav_search: "#A1A6BD" +published: true +slug: null +uuid: 9726d8b0-222f-eb2c-034a-02b9f51ef5fd version: 1.0.0 diff --git a/superset/examples/slack_dashboard/data/members_channels_2.parquet b/superset/examples/slack_dashboard/data/members_channels_2.parquet new file mode 100644 index 00000000000..94d24adc0a2 Binary files /dev/null and b/superset/examples/slack_dashboard/data/members_channels_2.parquet differ diff --git a/superset/examples/slack_dashboard/data/messages.parquet b/superset/examples/slack_dashboard/data/messages.parquet new file mode 100644 index 00000000000..cbd4e7b6d70 Binary files /dev/null and b/superset/examples/slack_dashboard/data/messages.parquet differ diff --git a/superset/examples/slack_dashboard/data/messages_channels.parquet b/superset/examples/slack_dashboard/data/messages_channels.parquet new file mode 100644 index 00000000000..a3b2d6ca77a Binary files /dev/null and b/superset/examples/slack_dashboard/data/messages_channels.parquet differ diff --git a/superset/examples/slack_dashboard/data/new_members_daily.parquet b/superset/examples/slack_dashboard/data/new_members_daily.parquet new file mode 100644 index 00000000000..519533c6742 Binary files /dev/null and b/superset/examples/slack_dashboard/data/new_members_daily.parquet differ diff --git a/superset/examples/slack_dashboard/data/threads.parquet b/superset/examples/slack_dashboard/data/threads.parquet new file mode 100644 index 00000000000..f9f6c54d468 Binary files /dev/null and b/superset/examples/slack_dashboard/data/threads.parquet differ diff --git a/superset/examples/slack_dashboard/data/users.parquet b/superset/examples/slack_dashboard/data/users.parquet new file mode 100644 index 00000000000..7461a2bbdd2 Binary files /dev/null and b/superset/examples/slack_dashboard/data/users.parquet differ diff --git a/superset/examples/slack_dashboard/data/users_channels-uzooNNtSRO.parquet b/superset/examples/slack_dashboard/data/users_channels-uzooNNtSRO.parquet new file mode 100644 index 00000000000..aaaf04949b6 Binary files /dev/null and b/superset/examples/slack_dashboard/data/users_channels-uzooNNtSRO.parquet differ diff --git a/superset/examples/configs/datasets/examples/members_channels_2.yaml b/superset/examples/slack_dashboard/datasets/members_channels_2.yaml similarity index 84% rename from superset/examples/configs/datasets/examples/members_channels_2.yaml rename to superset/examples/slack_dashboard/datasets/members_channels_2.yaml index a8ce28350c8..06b1c2526fa 100644 --- a/superset/examples/configs/datasets/examples/members_channels_2.yaml +++ b/superset/examples/slack_dashboard/datasets/members_channels_2.yaml @@ -14,50 +14,59 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -table_name: members_channels_2 -main_dttm_col: null -description: null -default_endpoint: null -offset: 0 +always_filter_main_dttm: false cache_timeout: null -schema: null -sql: SELECT c.name AS channel_name, u.name AS member_name FROM channel_members cm - JOIN channels c ON cm.channel_id = c.id JOIN users u ON cm.user_id = u.id -params: null -template_params: null -filter_select_enabled: true -fetch_values_predicate: null -extra: null -uuid: 3d9c0054-b31b-4102-92de-b1ef9f9e5e77 -metrics: -- metric_name: count - verbose_name: null - metric_type: null - expression: count(*) - description: null - d3format: null - extra: null - warning_text: null +catalog: null columns: -- column_name: channel_name - verbose_name: null - is_dttm: false - is_active: true - type: null - groupby: true - filterable: true - expression: null +- advanced_data_type: null + column_name: channel_name description: null - python_date_format: null -- column_name: member_name - verbose_name: null - is_dttm: false - is_active: true - type: null - groupby: true - filterable: true expression: null - description: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false python_date_format: null -version: 1.0.0 + type: null + verbose_name: null +- advanced_data_type: null + column_name: member_name + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: null + verbose_name: null +data_file: members_channels_2.parquet database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee +default_endpoint: null +description: null +extra: null +fetch_values_predicate: null +filter_select_enabled: true +folders: null +main_dttm_col: null +metrics: +- currency: null + d3format: null + description: null + expression: count(*) + extra: null + metric_name: count + metric_type: null + verbose_name: null + warning_text: null +normalize_columns: false +offset: 0 +params: null +schema: null +sql: null +table_name: members_channels_2 +template_params: null +uuid: 3d9c0054-b31b-4102-92de-b1ef9f9e5e77 +version: 1.0.0 diff --git a/superset/examples/configs/datasets/examples/messages.yaml b/superset/examples/slack_dashboard/datasets/messages.yaml similarity index 74% rename from superset/examples/configs/datasets/examples/messages.yaml rename to superset/examples/slack_dashboard/datasets/messages.yaml index f34f98dda41..cc55850b0dc 100644 --- a/superset/examples/configs/datasets/examples/messages.yaml +++ b/superset/examples/slack_dashboard/datasets/messages.yaml @@ -14,470 +14,563 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -table_name: messages -main_dttm_col: bot_profile__updated -description: null -default_endpoint: null -offset: 0 +always_filter_main_dttm: false cache_timeout: null +catalog: null +columns: +- advanced_data_type: null + column_name: bot_profile__updated + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: true + python_date_format: null + type: TIMESTAMP WITHOUT TIME ZONE + verbose_name: null +- advanced_data_type: null + column_name: last_read + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: true + python_date_format: null + type: TIMESTAMP WITHOUT TIME ZONE + verbose_name: null +- advanced_data_type: null + column_name: ts + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: true + python_date_format: null + type: TIMESTAMP WITHOUT TIME ZONE + verbose_name: null +- advanced_data_type: null + column_name: bot_profile__team_id + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: bot_profile__app_id + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: bot_profile__name + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: bot_profile__id + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: parent_user_id + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: client_msg_id + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: icons__emoji + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: channel_id + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: source_team + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: thread_ts + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: old_name + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: latest_reply + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: user_team + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: bot_id + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: file_id + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: username + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: permalink + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: name + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: team + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: subtype + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: topic + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: inviter + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: purpose + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: type + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: user + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: text + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: bot_profile__deleted + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BOOLEAN + verbose_name: null +- advanced_data_type: null + column_name: display_as_bot + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BOOLEAN + verbose_name: null +- advanced_data_type: null + column_name: is_delayed_message + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BOOLEAN + verbose_name: null +- advanced_data_type: null + column_name: is_starred + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BOOLEAN + verbose_name: null +- advanced_data_type: null + column_name: is_intro + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BOOLEAN + verbose_name: null +- advanced_data_type: null + column_name: upload + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BOOLEAN + verbose_name: null +- advanced_data_type: null + column_name: subscribed + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BOOLEAN + verbose_name: null +- advanced_data_type: null + column_name: reply_users_count + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: unread_count + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: reply_count + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: file_ids + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: pinned_to + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: reply_users + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: reactions + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: blocks + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +data_file: messages.parquet +database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee +default_endpoint: null +description: null +extra: null +fetch_values_predicate: null +filter_select_enabled: true +folders: null +main_dttm_col: bot_profile__updated +metrics: +- currency: null + d3format: null + description: null + expression: COUNT(*) + extra: null + metric_name: count + metric_type: count + verbose_name: COUNT(*) + warning_text: null +normalize_columns: false +offset: 0 +params: null schema: null sql: null -params: null +table_name: messages template_params: null -filter_select_enabled: true -fetch_values_predicate: null -extra: null uuid: e032c69e-716e-d700-eff7-07800d0f9989 -metrics: -- metric_name: count - verbose_name: COUNT(*) - metric_type: count - expression: COUNT(*) - description: null - d3format: null - extra: null - warning_text: null -columns: -- column_name: bot_profile__updated - verbose_name: null - is_dttm: true - is_active: true - type: TIMESTAMP WITHOUT TIME ZONE - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: last_read - verbose_name: null - is_dttm: true - is_active: true - type: TIMESTAMP WITHOUT TIME ZONE - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: ts - verbose_name: null - is_dttm: true - is_active: true - type: TIMESTAMP WITHOUT TIME ZONE - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: bot_profile__team_id - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: bot_profile__app_id - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: bot_profile__name - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: bot_profile__id - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: parent_user_id - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: client_msg_id - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: icons__emoji - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: channel_id - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: source_team - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: thread_ts - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: old_name - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: latest_reply - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: user_team - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: bot_id - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: file_id - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: username - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: permalink - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: name - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: team - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: subtype - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: topic - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: inviter - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: purpose - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: type - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: user - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: text - verbose_name: null - is_dttm: false - is_active: true - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: bot_profile__deleted - verbose_name: null - is_dttm: false - is_active: true - type: BOOLEAN - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: display_as_bot - verbose_name: null - is_dttm: false - is_active: true - type: BOOLEAN - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: is_delayed_message - verbose_name: null - is_dttm: false - is_active: true - type: BOOLEAN - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: is_starred - verbose_name: null - is_dttm: false - is_active: true - type: BOOLEAN - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: is_intro - verbose_name: null - is_dttm: false - is_active: true - type: BOOLEAN - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: upload - verbose_name: null - is_dttm: false - is_active: true - type: BOOLEAN - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: subscribed - verbose_name: null - is_dttm: false - is_active: true - type: BOOLEAN - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: reply_users_count - verbose_name: null - is_dttm: false - is_active: true - type: BIGINT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: unread_count - verbose_name: null - is_dttm: false - is_active: true - type: BIGINT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: reply_count - verbose_name: null - is_dttm: false - is_active: true - type: BIGINT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: file_ids - verbose_name: null - is_dttm: false - is_active: true - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: pinned_to - verbose_name: null - is_dttm: false - is_active: true - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: reply_users - verbose_name: null - is_dttm: false - is_active: true - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: reactions - verbose_name: null - is_dttm: false - is_active: true - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: blocks - verbose_name: null - is_dttm: false - is_active: true - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null version: 1.0.0 -database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee -data: examples://datasets/examples/slack/messages.csv diff --git a/superset/examples/configs/datasets/examples/messages_channels.yaml b/superset/examples/slack_dashboard/datasets/messages_channels.yaml similarity index 83% rename from superset/examples/configs/datasets/examples/messages_channels.yaml rename to superset/examples/slack_dashboard/datasets/messages_channels.yaml index e93a3efeeba..4d927f257b5 100644 --- a/superset/examples/configs/datasets/examples/messages_channels.yaml +++ b/superset/examples/slack_dashboard/datasets/messages_channels.yaml @@ -14,60 +14,71 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -table_name: messages_channels -main_dttm_col: null -description: null -default_endpoint: null -offset: 0 +always_filter_main_dttm: false cache_timeout: null -schema: null -sql: SELECT m.ts, c.name, m.text FROM messages m JOIN channels c ON m.channel_id = - c.id -params: null -template_params: null -filter_select_enabled: true -fetch_values_predicate: null -extra: null -uuid: 6e533506-fce6-4f6a-b116-d139df6dbdea -metrics: -- metric_name: count - verbose_name: null - metric_type: null - expression: count(*) - description: null - d3format: null - extra: null - warning_text: null +catalog: null columns: -- column_name: ts - verbose_name: null +- advanced_data_type: null + column_name: ts + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true is_dttm: true - is_active: true + python_date_format: null type: DATETIME - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: name verbose_name: null - is_dttm: false +- advanced_data_type: null + column_name: name + description: null + expression: null + extra: null + filterable: true + groupby: true is_active: true + is_dttm: false + python_date_format: null type: VAR_STRING - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: text verbose_name: null - is_dttm: false - is_active: true - type: BLOB - groupby: true - filterable: true - expression: null +- advanced_data_type: null + column_name: text description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false python_date_format: null -version: 1.0.0 + type: BLOB + verbose_name: null +data_file: messages_channels.parquet database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee +default_endpoint: null +description: null +extra: null +fetch_values_predicate: null +filter_select_enabled: true +folders: null +main_dttm_col: null +metrics: +- currency: null + d3format: null + description: null + expression: count(*) + extra: null + metric_name: count + metric_type: null + verbose_name: null + warning_text: null +normalize_columns: false +offset: 0 +params: null +schema: null +sql: null +table_name: messages_channels +template_params: null +uuid: 6e533506-fce6-4f6a-b116-d139df6dbdea +version: 1.0.0 diff --git a/superset/examples/configs/datasets/examples/new_members_daily.yaml b/superset/examples/slack_dashboard/datasets/new_members_daily.yaml similarity index 84% rename from superset/examples/configs/datasets/examples/new_members_daily.yaml rename to superset/examples/slack_dashboard/datasets/new_members_daily.yaml index 3a7996dd46a..7a1af9298cf 100644 --- a/superset/examples/configs/datasets/examples/new_members_daily.yaml +++ b/superset/examples/slack_dashboard/datasets/new_members_daily.yaml @@ -14,50 +14,59 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -table_name: new_members_daily -main_dttm_col: null -description: null -default_endpoint: null -offset: 0 +always_filter_main_dttm: false cache_timeout: null -schema: null -sql: SELECT date, total_membership - lag(total_membership) OVER (ORDER BY date) AS - new_members FROM exported_stats -params: null -template_params: null -filter_select_enabled: true -fetch_values_predicate: null -extra: null -uuid: 9dd99cda-ff6b-4575-9a74-684d06e871ab -metrics: -- metric_name: count - verbose_name: null - metric_type: null - expression: count(*) - description: null - d3format: null - extra: null - warning_text: null +catalog: null columns: -- column_name: date - verbose_name: null +- advanced_data_type: null + column_name: date + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true is_dttm: true - is_active: true + python_date_format: null type: DATETIME - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: new_members verbose_name: null - is_dttm: false - is_active: true - type: LONGLONG - groupby: true - filterable: true - expression: null +- advanced_data_type: null + column_name: new_members description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false python_date_format: null -version: 1.0.0 + type: LONGLONG + verbose_name: null +data_file: new_members_daily.parquet database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee +default_endpoint: null +description: null +extra: null +fetch_values_predicate: null +filter_select_enabled: true +folders: null +main_dttm_col: null +metrics: +- currency: null + d3format: null + description: null + expression: count(*) + extra: null + metric_name: count + metric_type: null + verbose_name: null + warning_text: null +normalize_columns: false +offset: 0 +params: null +schema: null +sql: null +table_name: new_members_daily +template_params: null +uuid: 9dd99cda-ff6b-4575-9a74-684d06e871ab +version: 1.0.0 diff --git a/superset/examples/configs/datasets/examples/threads.yaml b/superset/examples/slack_dashboard/datasets/threads.yaml similarity index 77% rename from superset/examples/configs/datasets/examples/threads.yaml rename to superset/examples/slack_dashboard/datasets/threads.yaml index c85d124b7d7..aa01a733579 100644 --- a/superset/examples/configs/datasets/examples/threads.yaml +++ b/superset/examples/slack_dashboard/datasets/threads.yaml @@ -14,170 +14,203 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -table_name: threads -main_dttm_col: ts -description: null -default_endpoint: null -offset: 0 +always_filter_main_dttm: false cache_timeout: null +catalog: null +columns: +- advanced_data_type: null + column_name: ts + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: true + python_date_format: null + type: TIMESTAMP WITHOUT TIME ZONE + verbose_name: null +- advanced_data_type: null + column_name: client_msg_id + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: channel_id + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: thread_ts + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: latest_reply + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: team + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: type + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: user + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: text + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: subscribed + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BOOLEAN + verbose_name: null +- advanced_data_type: null + column_name: reply_count + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: reply_users + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: blocks + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: TEXT + verbose_name: null +- advanced_data_type: null + column_name: reply_users_count + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +data_file: threads.parquet +database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee +default_endpoint: null +description: null +extra: null +fetch_values_predicate: null +filter_select_enabled: true +folders: null +main_dttm_col: ts +metrics: +- currency: null + d3format: null + description: null + expression: COUNT(*) + extra: null + metric_name: count + metric_type: count + verbose_name: COUNT(*) + warning_text: null +normalize_columns: false +offset: 0 +params: null schema: null sql: null -params: null +table_name: threads template_params: null -filter_select_enabled: true -fetch_values_predicate: null -extra: null uuid: d7438be6-6078-17dd-cf9a-56f0ef546c80 -metrics: -- metric_name: count - verbose_name: COUNT(*) - metric_type: count - expression: COUNT(*) - description: null - d3format: null - extra: null - warning_text: null -columns: -- column_name: ts - verbose_name: null - is_dttm: true - is_active: true - type: TIMESTAMP WITHOUT TIME ZONE - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: client_msg_id - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: channel_id - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: thread_ts - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: latest_reply - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: team - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: type - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: user - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: text - verbose_name: null - is_dttm: false - is_active: true - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: subscribed - verbose_name: null - is_dttm: false - is_active: true - type: BOOLEAN - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: reply_count - verbose_name: null - is_dttm: false - is_active: true - type: BIGINT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: reply_users - verbose_name: null - is_dttm: false - is_active: true - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: blocks - verbose_name: null - is_dttm: false - is_active: true - type: TEXT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: reply_users_count - verbose_name: null - is_dttm: false - is_active: true - type: BIGINT - groupby: true - filterable: true - expression: null - description: null - python_date_format: null version: 1.0.0 -database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee -data: examples://datasets/examples/slack/threads.csv diff --git a/superset/examples/configs/datasets/examples/exported_stats.yaml b/superset/examples/slack_dashboard/datasets/users.yaml similarity index 61% rename from superset/examples/configs/datasets/examples/exported_stats.yaml rename to superset/examples/slack_dashboard/datasets/users.yaml index cd71bde56fd..13319b3a3ce 100644 --- a/superset/examples/configs/datasets/examples/exported_stats.yaml +++ b/superset/examples/slack_dashboard/datasets/users.yaml @@ -14,250 +14,251 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -table_name: exported_stats -main_dttm_col: Date -description: null -default_endpoint: null -offset: 0 +always_filter_main_dttm: false cache_timeout: null -schema: null -sql: '' -params: null -template_params: null -filter_select_enabled: true -fetch_values_predicate: null -extra: null -uuid: 0bd5d01c-b7d8-471b-b3a5-366ce6c920d4 -metrics: -- metric_name: count - verbose_name: COUNT(*) - metric_type: null - expression: COUNT(*) - description: null - d3format: null - extra: null - warning_text: null +catalog: null columns: -- column_name: new_members - verbose_name: New Members - is_dttm: false +- advanced_data_type: null + column_name: updated + description: null + expression: null + extra: null + filterable: true + groupby: true is_active: true - type: BIGINT - groupby: true - filterable: true - expression: 'total_membership - LAG(total_membership) OVER (ORDER BY date)' - description: null - python_date_format: null -- column_name: percent_of_messages_private_channels - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: percent_of_messages_public_channels - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: percent_of_views_private_channels - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: percent_of_views_public_channels - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: percent_of_messages_dms - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: percent_of_views_dms - verbose_name: null - is_dttm: false - is_active: null - type: DOUBLE PRECISION - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: date - verbose_name: null is_dttm: true - is_active: null + python_date_format: null type: TIMESTAMP WITHOUT TIME ZONE - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: daily_members_posting_messages verbose_name: null - is_dttm: false - is_active: null - type: BIGINT - groupby: true - filterable: true - expression: null +- advanced_data_type: null + column_name: has_2fa description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false python_date_format: null -- column_name: messages_in_shared_channels + type: BOOLEAN verbose_name: null - is_dttm: false - is_active: null - type: BIGINT - groupby: true - filterable: true - expression: null +- advanced_data_type: null + column_name: real_name description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false python_date_format: null -- column_name: messages_in_private_channels + type: VARCHAR verbose_name: null - is_dttm: false - is_active: null - type: BIGINT - groupby: true - filterable: true - expression: null +- advanced_data_type: null + column_name: tz_label description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false python_date_format: null -- column_name: messages_in_public_channels + type: VARCHAR verbose_name: null - is_dttm: false - is_active: null - type: BIGINT - groupby: true - filterable: true - expression: null +- advanced_data_type: null + column_name: team_id description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false python_date_format: null -- column_name: weekly_members_posting_messages + type: VARCHAR verbose_name: null - is_dttm: false - is_active: null - type: BIGINT - groupby: true - filterable: true - expression: null +- advanced_data_type: null + column_name: name description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false python_date_format: null -- column_name: public_channels_single_workspace + type: VARCHAR verbose_name: null - is_dttm: false - is_active: null - type: BIGINT - groupby: true - filterable: true - expression: null +- advanced_data_type: null + column_name: color description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false python_date_format: null -- column_name: messages_in_dms + type: VARCHAR verbose_name: null - is_dttm: false - is_active: null - type: BIGINT - groupby: true - filterable: true - expression: null +- advanced_data_type: null + column_name: id description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false python_date_format: null -- column_name: daily_active_members + type: VARCHAR verbose_name: null - is_dttm: false - is_active: null - type: BIGINT - groupby: true - filterable: true - expression: null +- advanced_data_type: null + column_name: tz description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false python_date_format: null -- column_name: weekly_active_members + type: VARCHAR verbose_name: null - is_dttm: false - is_active: null - type: BIGINT - groupby: true - filterable: true - expression: null +- advanced_data_type: null + column_name: is_ultra_restricted description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false python_date_format: null -- column_name: full_members + type: BOOLEAN verbose_name: null - is_dttm: false - is_active: null - type: BIGINT - groupby: true - filterable: true - expression: null +- advanced_data_type: null + column_name: is_primary_owner description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false python_date_format: null -- column_name: messages_posted + type: BOOLEAN verbose_name: null - is_dttm: false - is_active: null - type: BIGINT - groupby: true - filterable: true - expression: null +- advanced_data_type: null + column_name: is_app_user description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false python_date_format: null -- column_name: total_membership + type: BOOLEAN verbose_name: null - is_dttm: false - is_active: null - type: BIGINT - groupby: true - filterable: true - expression: null +- advanced_data_type: null + column_name: is_admin description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false python_date_format: null -- column_name: guests + type: BOOLEAN verbose_name: null - is_dttm: false - is_active: null - type: BIGINT - groupby: true - filterable: true - expression: null +- advanced_data_type: null + column_name: is_bot description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false python_date_format: null -- column_name: name + type: BOOLEAN verbose_name: null - is_dttm: false - is_active: null - type: BIGINT - groupby: true - filterable: true - expression: null +- advanced_data_type: null + column_name: is_restricted description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false python_date_format: null -version: 1.0.0 + type: BOOLEAN + verbose_name: null +- advanced_data_type: null + column_name: is_owner + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BOOLEAN + verbose_name: null +- advanced_data_type: null + column_name: deleted + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BOOLEAN + verbose_name: null +- advanced_data_type: null + column_name: tz_offset + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +data_file: users.parquet database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee -data: examples://datasets/examples/slack/exported_stats.csv +default_endpoint: null +description: null +extra: null +fetch_values_predicate: null +filter_select_enabled: true +folders: null +main_dttm_col: updated +metrics: +- currency: null + d3format: null + description: null + expression: COUNT(*) + extra: null + metric_name: count + metric_type: count + verbose_name: COUNT(*) + warning_text: null +normalize_columns: false +offset: 0 +params: null +schema: null +sql: null +table_name: users +template_params: null +uuid: 7195db6b-2d17-7619-b7c7-26b15378df8c +version: 1.0.0 diff --git a/superset/examples/configs/datasets/examples/channel_members.yaml b/superset/examples/slack_dashboard/datasets/users_channels-uzooNNtSRO.yaml similarity index 67% rename from superset/examples/configs/datasets/examples/channel_members.yaml rename to superset/examples/slack_dashboard/datasets/users_channels-uzooNNtSRO.yaml index a528838e485..91481ef2891 100644 --- a/superset/examples/configs/datasets/examples/channel_members.yaml +++ b/superset/examples/slack_dashboard/datasets/users_channels-uzooNNtSRO.yaml @@ -14,50 +14,71 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -table_name: channel_members -main_dttm_col: null -description: null -default_endpoint: null -offset: 0 +always_filter_main_dttm: false cache_timeout: null +catalog: null +columns: +- advanced_data_type: null + column_name: channel_1 + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: STRING + verbose_name: null +- advanced_data_type: null + column_name: channel_2 + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: STRING + verbose_name: null +- advanced_data_type: null + column_name: cnt + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: INT + verbose_name: null +data_file: users_channels-uzooNNtSRO.parquet +database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee +default_endpoint: null +description: null +extra: null +fetch_values_predicate: null +filter_select_enabled: true +folders: null +main_dttm_col: null +metrics: +- currency: null + d3format: null + description: null + expression: count(*) + extra: null + metric_name: count + metric_type: null + verbose_name: null + warning_text: null +normalize_columns: false +offset: 0 +params: null schema: null sql: null -params: null +table_name: users_channels-uzooNNtSRO template_params: null -filter_select_enabled: true -fetch_values_predicate: null -extra: null -uuid: 3e8130eb-0831-d568-b531-c3ce6d68d3d8 -metrics: -- metric_name: count - verbose_name: COUNT(*) - metric_type: count - expression: COUNT(*) - description: null - d3format: null - extra: null - warning_text: null -columns: -- column_name: channel_id - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null -- column_name: user_id - verbose_name: null - is_dttm: false - is_active: true - type: VARCHAR - groupby: true - filterable: true - expression: null - description: null - python_date_format: null +uuid: 473d6113-b44a-48d8-a6ae-e0ef7e2aebb0 version: 1.0.0 -database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee -data: examples://datasets/examples/slack/channel_members.csv diff --git a/superset/examples/supported_charts_dashboard.py b/superset/examples/supported_charts_dashboard.py deleted file mode 100644 index a77fd515d48..00000000000 --- a/superset/examples/supported_charts_dashboard.py +++ /dev/null @@ -1,1251 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -# pylint: disable=too-many-lines -import logging -import textwrap - -from sqlalchemy import inspect - -from superset import db -from superset.connectors.sqla.models import SqlaTable -from superset.models.dashboard import Dashboard -from superset.models.slice import Slice -from superset.sql.parse import Table -from superset.utils import json -from superset.utils.core import DatasourceType - -from ..utils.database import get_example_database # noqa: TID252 -from .helpers import ( - get_slice_json, - get_table_connector_registry, - merge_slice, - update_slice_ids, -) - -DASH_SLUG = "supported_charts_dash" -logger = logging.getLogger(__name__) - - -def create_slices(tbl: SqlaTable) -> list[Slice]: - slice_kwargs = { - "datasource_id": tbl.id, - "datasource_type": DatasourceType.TABLE, - "owners": [], - } - - defaults = { - "limit": "25", - "time_range": "100 years ago : now", - "granularity_sqla": "ds", - "row_limit": "50000", - "viz_type": "echarts_timeseries_bar", - } - - slices = [ - # --------------------- - # TIER 1 - # --------------------- - Slice( - **slice_kwargs, - slice_name="Big Number", - viz_type="big_number_total", - params=get_slice_json( - defaults, - viz_type="big_number_total", - metric="sum__num", - ), - ), - Slice( - **slice_kwargs, - slice_name="Big Number with Trendline", - viz_type="big_number", - params=get_slice_json( - defaults, - viz_type="big_number", - metric="sum__num", - ), - ), - Slice( - **slice_kwargs, - slice_name="Table", - viz_type="table", - params=get_slice_json( - defaults, - viz_type="table", - metrics=["sum__num"], - groupby=["gender"], - ), - ), - Slice( - **slice_kwargs, - slice_name="Pivot Table", - viz_type="pivot_table_v2", - params=get_slice_json( - defaults, - viz_type="pivot_table_v2", - metrics=["sum__num"], - groupbyColumns=["gender"], - groupbyRows=["state"], - ), - ), - Slice( - **slice_kwargs, - slice_name="Line Chart", - viz_type="echarts_timeseries_line", - params=get_slice_json( - defaults, - viz_type="echarts_timeseries_line", - metrics=["sum__num"], - groupby=["gender"], - ), - ), - Slice( - **slice_kwargs, - slice_name="Area Chart", - viz_type="echarts_area", - params=get_slice_json( - defaults, - viz_type="echarts_area", - metrics=["sum__num"], - groupby=["gender"], - ), - ), - Slice( - **slice_kwargs, - slice_name="Bar Chart", - viz_type="echarts_timeseries_bar", - params=get_slice_json( - defaults, - viz_type="echarts_timeseries_bar", - metrics=["sum__num"], - groupby=["gender"], - ), - ), - Slice( - **slice_kwargs, - slice_name="Scatter Chart", - viz_type="echarts_timeseries_scatter", - params=get_slice_json( - defaults, - viz_type="echarts_timeseries_scatter", - metrics=["sum__num"], - groupby=["gender"], - ), - ), - Slice( - **slice_kwargs, - slice_name="Pie Chart", - viz_type="pie", - params=get_slice_json( - defaults, - viz_type="pie", - metric="sum__num", - groupby=["gender"], - adhoc_filters=[], - ), - ), - # --------------------- - # TIER 2 - # --------------------- - Slice( - **slice_kwargs, - slice_name="Box Plot Chart", - viz_type="box_plot", - params=get_slice_json( - defaults, - viz_type="box_plot", - metrics=["sum__num"], - groupby=["gender"], - columns=["name"], - ), - ), - Slice( - **slice_kwargs, - slice_name="Bubble Chart", - viz_type="bubble", - params=get_slice_json( - defaults, - viz_type="bubble", - size="count", - series="state", - entity="gender", - x={ - "expressionType": "SIMPLE", - "column": { - "column_name": "num_boys", - }, - "aggregate": "SUM", - "label": "SUM(num_boys)", - "optionName": "metric_353e7rjj84m_cirsi2o2s1", - }, - y={ - "expressionType": "SIMPLE", - "column": { - "column_name": "num_girls", - }, - "aggregate": "SUM", - "label": "SUM(num_girls)", - "optionName": "metric_n8rvsr2ysmr_cb3eybtoe5f", - }, - ), - ), - Slice( - **slice_kwargs, - slice_name="Calendar Heatmap", - viz_type="cal_heatmap", - params=get_slice_json( - defaults, - viz_type="cal_heatmap", - metrics=["sum__num"], - time_range="2008-01-01 : 2008-02-01", - ), - ), - Slice( - **slice_kwargs, - slice_name="Chord Chart", - viz_type="chord", - params=get_slice_json( - defaults, - viz_type="chord", - metric="sum__num", - groupby="gender", - columns="state", - ), - ), - Slice( - **slice_kwargs, - slice_name="Percent Change Chart", - viz_type="compare", - params=get_slice_json( - defaults, - viz_type="compare", - metrics=["sum__num"], - groupby=["gender"], - ), - ), - Slice( - **slice_kwargs, - slice_name="Generic Chart", - viz_type="echarts_timeseries", - params=get_slice_json( - defaults, - viz_type="echarts_timeseries", - metrics=["sum__num"], - groupby=["gender"], - ), - ), - Slice( - **slice_kwargs, - slice_name="Smooth Line Chart", - viz_type="echarts_timeseries_smooth", - params=get_slice_json( - defaults, - viz_type="echarts_timeseries_smooth", - metrics=["sum__num"], - groupby=["gender"], - ), - ), - Slice( - **slice_kwargs, - slice_name="Step Line Chart", - viz_type="echarts_timeseries_step", - params=get_slice_json( - defaults, - viz_type="echarts_timeseries_step", - metrics=["sum__num"], - groupby=["gender"], - ), - ), - Slice( - **slice_kwargs, - slice_name="Funnel Chart", - viz_type="funnel", - params=get_slice_json( - defaults, - viz_type="funnel", - metric="sum__num", - groupby=["gender"], - ), - ), - Slice( - **slice_kwargs, - slice_name="Gauge Chart", - viz_type="gauge_chart", - params=get_slice_json( - defaults, - viz_type="gauge_chart", - metric="sum__num", - groupby=["gender"], - ), - ), - Slice( - **slice_kwargs, - slice_name="Heatmap Chart", - viz_type="heatmap_v2", - params=get_slice_json( - defaults, - viz_type="heatmap_v2", - metric="sum__num", - x_axis="gender", - groupby="state", - sort_x_axis="value_asc", - sort_y_axis="value_asc", - ), - ), - Slice( - **slice_kwargs, - slice_name="Line Chart", - viz_type="echarts_timeseries_line", - params=get_slice_json( - defaults, - viz_type="echarts_timeseries_line", - metrics=["sum__num"], - groupby=["gender"], - ), - ), - Slice( - **slice_kwargs, - slice_name="Mixed Chart", - viz_type="mixed_timeseries", - params=get_slice_json( - defaults, - viz_type="mixed_timeseries", - metrics=["sum__num"], - groupby=["gender"], - metrics_b=["sum__num"], - groupby_b=["state"], - ), - ), - Slice( - **slice_kwargs, - slice_name="Partition Chart", - viz_type="partition", - params=get_slice_json( - defaults, - viz_type="partition", - metrics=["sum__num"], - groupby=["gender"], - ), - ), - Slice( - **slice_kwargs, - slice_name="Radar Chart", - viz_type="radar", - params=get_slice_json( - defaults, - viz_type="radar", - metrics=[ - "sum__num", - "count", - { - "expressionType": "SIMPLE", - "column": { - "column_name": "num_boys", - }, - "aggregate": "SUM", - "label": "SUM(num_boys)", - "optionName": "metric_353e7rjj84m_cirsi2o2s1", - }, - ], - groupby=["gender"], - ), - ), - Slice( - **slice_kwargs, - slice_name="Nightingale Chart", - viz_type="rose", - params=get_slice_json( - defaults, - viz_type="rose", - metrics=["sum__num"], - groupby=["gender"], - ), - ), - Slice( - **slice_kwargs, - slice_name="Sankey Chart", - viz_type="sankey_v2", - params=get_slice_json( - defaults, - viz_type="sankey_v2", - metric="sum__num", - source="gender", - target="state", - ), - ), - Slice( - **slice_kwargs, - slice_name="Sunburst Chart", - viz_type="sunburst_v2", - params=get_slice_json( - defaults, - viz_type="sunburst_v2", - metric="sum__num", - columns=["gender", "state"], - ), - ), - Slice( - **slice_kwargs, - slice_name="Treemap V2 Chart", - viz_type="treemap_v2", - params=get_slice_json( - defaults, - viz_type="treemap_v2", - metric="sum__num", - groupby=["gender"], - ), - ), - Slice( - **slice_kwargs, - slice_name="Word Cloud Chart", - viz_type="word_cloud", - params=get_slice_json( - defaults, - viz_type="word_cloud", - metric="sum__num", - series="state", - ), - ), - ] - - for slc in slices: - merge_slice(slc) - - return slices - - -def load_supported_charts_dashboard() -> None: - """Loading a dashboard featuring supported charts""" - - database = get_example_database() - with database.get_sqla_engine() as engine: - schema = inspect(engine).default_schema_name - - tbl_name = "birth_names" - table_exists = database.has_table(Table(tbl_name, schema)) - - if table_exists: - table = get_table_connector_registry() - obj = ( - db.session.query(table) - .filter_by(table_name=tbl_name, schema=schema) - .first() - ) - create_slices(obj) - - logger.debug("Creating the dashboard") - - db.session.expunge_all() - dash = db.session.query(Dashboard).filter_by(slug=DASH_SLUG).first() - - if not dash: - dash = Dashboard() - - js = textwrap.dedent( - """ -{ - "CHART-1": { - "children": [], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-1", - "ROW-1" - ], - "id": "CHART-1", - "meta": { - "chartId": 1, - "height": 50, - "sliceName": "Big Number", - "width": 4 - }, - "type": "CHART" - }, - "CHART-2": { - "children": [], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-1", - "ROW-1" - ], - "id": "CHART-2", - "meta": { - "chartId": 2, - "height": 50, - "sliceName": "Big Number with Trendline", - "width": 4 - }, - "type": "CHART" - }, - "CHART-3": { - "children": [], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-1", - "ROW-1" - ], - "id": "CHART-3", - "meta":{ - "chartId": 3, - "height": 50, - "sliceName": "Table", - "width": 4 - }, - "type": "CHART" - }, - "CHART-4": { - "children": [], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-1", - "ROW-2" - ], - "id": "CHART-4", - "meta": { - "chartId": 4, - "height": 50, - "sliceName": "Pivot Table", - "width": 4 - }, - "type": "CHART" - }, - "CHART-5": { - "children": [], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-1", - "ROW-2" - ], - "id": "CHART-5", - "meta": { - "chartId": 5, - "height": 50, - "sliceName": "Line Chart", - "width": 4 - }, - "type": "CHART" - }, - "CHART-6": { - "children": [], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-1", - "ROW-2" - ], - "id": "CHART-6", - "meta": { - "chartId": 6, - "height": 50, - "sliceName": "Bar Chart", - "width": 4 - }, - "type": "CHART" - }, - "CHART-7": { - "children": [], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-1", - "ROW-3" - ], - "id": "CHART-7", - "meta": { - "chartId": 7, - "height": 50, - "sliceName": "Area Chart", - "width": 4 - }, - "type": "CHART" - }, - "CHART-8": { - "children": [], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-1", - "ROW-3" - ], - "id": "CHART-8", - "meta": { - "chartId": 8, - "height": 50, - "sliceName": "Scatter Chart", - "width": 4 - }, - "type": "CHART" - }, - "CHART-9": { - "children": [], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-1", - "ROW-3" - ], - "id": "CHART-9", - "meta": { - "chartId": 9, - "height": 50, - "sliceName": "Pie Chart", - "width": 4 - }, - "type": "CHART" - }, - "CHART-11": { - "children": [], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-1", - "ROW-4" - ], - "id": "CHART-11", - "meta": { - "chartId": 11, - "height": 50, - "sliceName": "% Rural", - "width": 4 - }, - "type": "CHART" - }, - "CHART-12": { - "children": [], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-2", - "ROW-5" - ], - "id": "CHART-12", - "meta": { - "chartId": 12, - "height": 50, - "sliceName": "Box Plot Chart", - "width": 4 - }, - "type": "CHART" - }, - "CHART-13": { - "children": [], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-2", - "ROW-5" - ], - "id": "CHART-13", - "meta": { - "chartId": 13, - "height": 50, - "sliceName": "Bubble Chart", - "width": 4 - }, - "type": "CHART" - }, - "CHART-14": { - "children": [], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-2", - "ROW-5" - ], - "id": "CHART-14", - "meta": { - "chartId": 14, - "height": 50, - "sliceName": "Calendar Heatmap", - "width": 4 - }, - "type": "CHART" - }, - "CHART-15": { - "children": [], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-2", - "ROW-6" - ], - "id": "CHART-15", - "meta": { - "chartId": 15, - "height": 50, - "sliceName": "Chord Chart", - "width": 4 - }, - "type": "CHART" - }, - "CHART-16": { - "children": [], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-2", - "ROW-6" - ], - "id": "CHART-16", - "meta": { - "chartId": 16, - "height": 50, - "sliceName": "Percent Change Chart", - "width": 4 - }, - "type": "CHART" - }, - "CHART-17": { - "children": [], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-2", - "ROW-6" - ], - "id": "CHART-17", - "meta": { - "chartId": 17, - "height": 50, - "sliceName": "Generic Chart", - "width": 4 - }, - "type": "CHART" - }, - "CHART-18": { - "children": [], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-2", - "ROW-7" - ], - "id": "CHART-18", - "meta": { - "chartId": 18, - "height": 50, - "sliceName": "Smooth Line Chart", - "width": 4 - }, - "type": "CHART" - }, - "CHART-19": { - "children": [], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-2", - "ROW-7" - ], - "id": "CHART-19", - "meta": { - "chartId": 19, - "height": 50, - "sliceName": "Step Line Chart", - "width": 4 - }, - "type": "CHART" - }, - "CHART-20": { - "children": [], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-2", - "ROW-7" - ], - "id": "CHART-20", - "meta": { - "chartId": 20, - "height": 50, - "sliceName": "Funnel Chart", - "width": 4 - }, - "type": "CHART" - }, - "CHART-21": { - "children": [], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-2", - "ROW-8" - ], - "id": "CHART-21", - "meta": { - "chartId": 21, - "height": 50, - "sliceName": "Gauge Chart", - "width": 4 - }, - "type": "CHART" - }, - "CHART-22": { - "children": [], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-2", - "ROW-8" - ], - "id": "CHART-22", - "meta": { - "chartId": 22, - "height": 50, - "sliceName": "Heatmap Chart", - "width": 4 - }, - "type": "CHART" - }, - "CHART-23": { - "children": [], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-2", - "ROW-8" - ], - "id": "CHART-23", - "meta": { - "chartId": 23, - "height": 50, - "sliceName": "Line Chart", - "width": 4 - }, - "type": "CHART" - }, - "CHART-24": { - "children": [], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-2", - "ROW-9" - ], - "id": "CHART-24", - "meta": { - "chartId": 24, - "height": 50, - "sliceName": "Mixed Chart", - "width": 4 - }, - "type": "CHART" - }, - "CHART-25": { - "children": [], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-2", - "ROW-9" - ], - "id": "CHART-25", - "meta": { - "chartId": 25, - "height": 50, - "sliceName": "Partition Chart", - "width": 4 - }, - "type": "CHART" - }, - "CHART-26": { - "children": [], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-2", - "ROW-9" - ], - "id": "CHART-26", - "meta": { - "chartId": 26, - "height": 50, - "sliceName": "Radar Chart", - "width": 4 - }, - "type": "CHART" - }, - "CHART-27": { - "children": [], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-2", - "ROW-10" - ], - "id": "CHART-27", - "meta": { - "chartId": 27, - "height": 50, - "sliceName": "Nightingale Chart", - "width": 4 - }, - "type": "CHART" - }, - "CHART-28": { - "children": [], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-2", - "ROW-10" - ], - "id": "CHART-28", - "meta": { - "chartId": 28, - "height": 50, - "sliceName": "Sankey Chart", - "width": 4 - }, - "type": "CHART" - }, - "CHART-29": { - "children": [], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-2", - "ROW-10" - ], - "id": "CHART-29", - "meta": { - "chartId": 29, - "height": 50, - "sliceName": "Sunburst Chart", - "width": 4 - }, - "type": "CHART" - }, - "CHART-30": { - "children": [], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-2", - "ROW-11" - ], - "id": "CHART-30", - "meta": { - "chartId": 30, - "height": 50, - "sliceName": "Treemap Chart", - "width": 4 - }, - "type": "CHART" - }, - "CHART-31": { - "children": [], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-2", - "ROW-11" - ], - "id": "CHART-31", - "meta": { - "chartId": 31, - "height": 50, - "sliceName": "Treemap V2 Chart", - "width": 4 - }, - "type": "CHART" - }, - "CHART-32": { - "children": [], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-2", - "ROW-11" - ], - "id": "CHART-32", - "meta": { - "chartId": 32, - "height": 50, - "sliceName": "Word Cloud Chart", - "width": 4 - }, - "type": "CHART" - }, - "GRID_ID": { - "children": [], - "id": "GRID_ID", - "type": "GRID" - }, - "HEADER_ID": { - "id": "HEADER_ID", - "meta": { - "text": "Supported Charts" - }, - "type": "HEADER" - }, - "TABS-TOP": { - "children": [ - "TAB-TOP-1", - "TAB-TOP-2" - ], - "id": "TABS-TOP", - "type": "TABS" - }, - "TAB-TOP-1": { - "id": "TAB_TOP-1", - "type": "TAB", - "meta": { - "text": "Tier 1", - "defaultText": "Tab title", - "placeholder": "Tab title" - }, - "parents": [ - "ROOT_ID", - "TABS-TOP" - ], - "children": [ - "ROW-1", - "ROW-2", - "ROW-3", - "ROW-4" - ] - }, - "TAB-TOP-2": { - "id": "TAB_TOP-2", - "type": "TAB", - "meta": { - "text": "Tier 2", - "defaultText": "Tab title", - "placeholder": "Tab title" - }, - "parents": [ - "ROOT_ID", - "TABS-TOP" - ], - "children": [ - "ROW-5", - "ROW-6", - "ROW-7", - "ROW-8", - "ROW-9", - "ROW-10", - "ROW-11" - ] - }, - "ROOT_ID": { - "children": [ - "TABS-TOP" - ], - "id": "ROOT_ID", - "type": "ROOT" - }, - "ROW-1": { - "children": [ - "CHART-1", - "CHART-2", - "CHART-3" - ], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-1" - ], - "id": "ROW-1", - "meta": { - "background": "BACKGROUND_TRANSPARENT" - }, - "type": "ROW" - }, - "ROW-2": { - "children": [ - "CHART-4", - "CHART-5", - "CHART-6" - ], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-1" - ], - "id": "ROW-2", - "meta": { - "background": "BACKGROUND_TRANSPARENT" - }, - "type": "ROW" - }, - "ROW-3": { - "children": [ - "CHART-7", - "CHART-8", - "CHART-9" - ], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-1" - ], - "id": "ROW-3", - "meta": { - "background": "BACKGROUND_TRANSPARENT" - }, - "type": "ROW" - }, - "ROW-4": { - "children": [ - "CHART-10", - "CHART-11" - ], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-1" - ], - "id": "ROW-4", - "meta": { - "background": "BACKGROUND_TRANSPARENT" - }, - "type": "ROW" - }, - "ROW-5": { - "children": [ - "CHART-12", - "CHART-13", - "CHART-14" - ], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-2" - ], - "id": "ROW-5", - "meta": { - "background": "BACKGROUND_TRANSPARENT" - }, - "type": "ROW" - }, - "ROW-6": { - "children": [ - "CHART-15", - "CHART-16", - "CHART-17" - ], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-2" - ], - "id": "ROW-6", - "meta": { - "background": "BACKGROUND_TRANSPARENT" - }, - "type": "ROW" - }, - "ROW-7": { - "children": [ - "CHART-18", - "CHART-19", - "CHART-20" - ], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-2" - ], - "id": "ROW-7", - "meta": { - "background": "BACKGROUND_TRANSPARENT" - }, - "type": "ROW" - }, - "ROW-8": { - "children": [ - "CHART-21", - "CHART-22", - "CHART-23" - ], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-2" - ], - "id": "ROW-8", - "meta": { - "background": "BACKGROUND_TRANSPARENT" - }, - "type": "ROW" - }, - "ROW-9": { - "children": [ - "CHART-24", - "CHART-25", - "CHART-26" - ], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-2" - ], - "id": "ROW-9", - "meta": { - "background": "BACKGROUND_TRANSPARENT" - }, - "type": "ROW" - }, - "ROW-10": { - "children": [ - "CHART-27", - "CHART-28", - "CHART-29" - ], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-2" - ], - "id": "ROW-10", - "meta": { - "background": "BACKGROUND_TRANSPARENT" - }, - "type": "ROW" - }, - "ROW-11": { - "children": [ - "CHART-30", - "CHART-31", - "CHART-32" - ], - "parents": [ - "ROOT_ID", - "TABS-TOP", - "TAB-TOP-2" - ], - "id": "ROW-11", - "meta": { - "background": "BACKGROUND_TRANSPARENT" - }, - "type": "ROW" - }, - "DASHBOARD_VERSION_KEY": "v2" -} - """ - ) - - pos = json.loads(js) - dash.slices = update_slice_ids(pos) - dash.dashboard_title = "Supported Charts Dashboard" - dash.position_json = json.dumps(pos, indent=2) - dash.slug = DASH_SLUG diff --git a/superset/examples/tabbed_dashboard.py b/superset/examples/tabbed_dashboard.py deleted file mode 100644 index ef0272cd608..00000000000 --- a/superset/examples/tabbed_dashboard.py +++ /dev/null @@ -1,561 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -import logging -import textwrap - -from superset import db -from superset.models.dashboard import Dashboard -from superset.utils import json - -from .helpers import update_slice_ids - -logger = logging.getLogger(__name__) - - -def load_tabbed_dashboard(_: bool = False) -> None: - """Creating a tabbed dashboard""" - - logger.debug("Creating a dashboard with nested tabs") - slug = "tabbed_dash" - dash = db.session.query(Dashboard).filter_by(slug=slug).first() - - if not dash: - dash = Dashboard() - db.session.add(dash) - - js = textwrap.dedent( - """ -{ - "CHART-06Kg-rUggO": { - "children": [], - "id": "CHART-06Kg-rUggO", - "meta": { - "chartId": 617, - "height": 42, - "sliceName": "Number of Girls", - "width": 4 - }, - "parents": [ - "ROOT_ID", - "TABS-lV0r00f4H1", - "TAB-NF3dlrWGS", - "ROW-kHj58UJg5N", - "COLUMN-_o23occSTg", - "TABS-CslNeIC6x8", - "TAB-SDz1jDqYZ2", - "ROW-DnYkJgKQE" - ], - "type": "CHART" - }, - "CHART-E4rQMdzY9-": { - "children": [], - "id": "CHART-E4rQMdzY9-", - "meta": { - "chartId": 616, - "height": 41, - "sliceName": "Names Sorted by Num in California", - "width": 4 - }, - "parents": [ - "ROOT_ID", - "TABS-lV0r00f4H1", - "TAB-NF3dlrWGS", - "ROW-kHj58UJg5N", - "COLUMN-_o23occSTg", - "TABS-CslNeIC6x8", - "TAB-SDz1jDqYZ2", - "ROW-DnYkJgKQE" - ], - "type": "CHART" - }, - "CHART-WO52N6b5de": { - "children": [], - "id": "CHART-WO52N6b5de", - "meta": { - "chartId": 615, - "height": 41, - "sliceName": "Top 10 California Names Timeseries", - "width": 8 - }, - "parents": [ - "ROOT_ID", - "TABS-lV0r00f4H1", - "TAB-NF3dlrWGS", - "ROW-kHj58UJg5N", - "COLUMN-_o23occSTg", - "TABS-CslNeIC6x8", - "TAB-t54frVKlx", - "ROW-ghqEVzr2fA" - ], - "type": "CHART" - }, - "CHART-c0EjR-OZ0n": { - "children": [], - "id": "CHART-c0EjR-OZ0n", - "meta": { - "chartId": 598, - "height": 50, - "sliceName": "Treemap", - "width": 4 - }, - "parents": [ - "ROOT_ID", - "TABS-lV0r00f4H1", - "TAB-NF3dlrWGS", - "ROW-kHj58UJg5N", - "COLUMN-RGd6kjW57J" - ], - "type": "CHART" - }, - "CHART-dxV7Il74hH": { - "children": [], - "id": "CHART-dxV7Il74hH", - "meta": { - "chartId": 597, - "height": 50, - "sliceName": "Box plot", - "width": 4 - }, - "parents": [ - "ROOT_ID", - "TABS-lV0r00f4H1", - "TAB-gcQJxApOZS", - "TABS-afnrUvdxYF", - "TAB-jNNd4WWar1", - "ROW-7ygtDczaQ" - ], - "type": "CHART" - }, - "CHART-dxV7Il666H": { - "children": [], - "id": "CHART-dxV7Il666H", - "meta": { - "chartId": 5539, - "height": 50, - "sliceName": "Trends", - "width": 4 - }, - "parents": [ - "ROOT_ID", - "TABS-lV0r00f4H1", - "TAB-gcQJxApOZS", - "TABS-afnrUvdxYF", - "TAB-jNNd4WWar1", - "ROW-7ygtD666Q" - ], - "type": "CHART" - }, - "CHART-jJ5Yj1Ptaz": { - "children": [], - "id": "CHART-jJ5Yj1Ptaz", - "meta": { - "chartId": 592, - "height": 29, - "sliceName": "Growth Rate", - "width": 5 - }, - "parents": [ - "ROOT_ID", - "TABS-lV0r00f4H1", - "TAB-NF3dlrWGS", - "TABS-CSjo6VfNrj", - "TAB-z81Q87PD7", - "ROW-G73z9PIHn" - ], - "type": "CHART" - }, - "CHART-z4gmEuCqQ5": { - "children": [], - "id": "CHART-z4gmEuCqQ5", - "meta": { - "chartId": 589, - "height": 50, - "sliceName": "Region Filter", - "width": 4 - }, - "parents": [ - "ROOT_ID", - "TABS-lV0r00f4H1", - "TAB-NF3dlrWGS", - "TABS-CSjo6VfNrj", - "TAB-EcNm_wh922", - "ROW-LCjsdSetJ" - ], - "type": "CHART" - }, - "COLUMN-RGd6kjW57J": { - "children": ["CHART-c0EjR-OZ0n"], - "id": "COLUMN-RGd6kjW57J", - "meta": { "background": "BACKGROUND_TRANSPARENT", "width": 4 }, - "parents": [ - "ROOT_ID", - "TABS-lV0r00f4H1", - "TAB-NF3dlrWGS", - "ROW-kHj58UJg5N" - ], - "type": "COLUMN" - }, - "COLUMN-V6vsdWdOEJ": { - "children": ["TABS-urzRuDRusW"], - "id": "COLUMN-V6vsdWdOEJ", - "meta": { "background": "BACKGROUND_TRANSPARENT", "width": 7 }, - "parents": [ - "ROOT_ID", - "TABS-lV0r00f4H1", - "TAB-NF3dlrWGS", - "TABS-CSjo6VfNrj", - "TAB-z81Q87PD7", - "ROW-G73z9PIHn" - ], - "type": "COLUMN" - }, - "COLUMN-_o23occSTg": { - "children": ["TABS-CslNeIC6x8"], - "id": "COLUMN-_o23occSTg", - "meta": { "background": "BACKGROUND_TRANSPARENT", "width": 8 }, - "parents": [ - "ROOT_ID", - "TABS-lV0r00f4H1", - "TAB-NF3dlrWGS", - "ROW-kHj58UJg5N" - ], - "type": "COLUMN" - }, - "DASHBOARD_VERSION_KEY": "v2", - "GRID_ID": { "children": [], "id": "GRID_ID", "type": "GRID" }, - "HEADER_ID": { - "id": "HEADER_ID", - "type": "HEADER", - "meta": { "text": "Tabbed Dashboard" } - }, - "ROOT_ID": { - "children": ["TABS-lV0r00f4H1"], - "id": "ROOT_ID", - "type": "ROOT" - }, - "ROW-7ygtDczaQ": { - "children": ["CHART-dxV7Il74hH"], - "id": "ROW-7ygtDczaQ", - "meta": { "background": "BACKGROUND_TRANSPARENT" }, - "parents": [ - "ROOT_ID", - "TABS-lV0r00f4H1", - "TAB-gcQJxApOZS", - "TABS-afnrUvdxYF", - "TAB-jNNd4WWar1" - ], - "type": "ROW" - }, - "ROW-7ygtD666Q": { - "children": ["CHART-dxV7Il666H"], - "id": "ROW-7ygtD666Q", - "meta": { "background": "BACKGROUND_TRANSPARENT" }, - "parents": [ - "ROOT_ID", - "TABS-lV0r00f4H1", - "TAB-gcQJxApOZS", - "TABS-afnrUvdxYF", - "TAB-jNNd4WWar1" - ], - "type": "ROW" - }, - "ROW-DnYkJgKQE": { - "children": ["CHART-06Kg-rUggO", "CHART-E4rQMdzY9-"], - "id": "ROW-DnYkJgKQE", - "meta": { "background": "BACKGROUND_TRANSPARENT" }, - "parents": [ - "ROOT_ID", - "TABS-lV0r00f4H1", - "TAB-NF3dlrWGS", - "ROW-kHj58UJg5N", - "COLUMN-_o23occSTg", - "TABS-CslNeIC6x8", - "TAB-SDz1jDqYZ2" - ], - "type": "ROW" - }, - "ROW-G73z9PIHn": { - "children": ["CHART-jJ5Yj1Ptaz", "COLUMN-V6vsdWdOEJ"], - "id": "ROW-G73z9PIHn", - "meta": { "background": "BACKGROUND_TRANSPARENT" }, - "parents": [ - "ROOT_ID", - "TABS-lV0r00f4H1", - "TAB-NF3dlrWGS", - "TABS-CSjo6VfNrj", - "TAB-z81Q87PD7" - ], - "type": "ROW" - }, - "ROW-LCjsdSetJ": { - "children": ["CHART-z4gmEuCqQ5"], - "id": "ROW-LCjsdSetJ", - "meta": { "background": "BACKGROUND_TRANSPARENT" }, - "parents": [ - "ROOT_ID", - "TABS-lV0r00f4H1", - "TAB-NF3dlrWGS", - "TABS-CSjo6VfNrj", - "TAB-EcNm_wh922" - ], - "type": "ROW" - }, - "ROW-ghqEVzr2fA": { - "children": ["CHART-WO52N6b5de"], - "id": "ROW-ghqEVzr2fA", - "meta": { "background": "BACKGROUND_TRANSPARENT" }, - "parents": [ - "ROOT_ID", - "TABS-lV0r00f4H1", - "TAB-NF3dlrWGS", - "ROW-kHj58UJg5N", - "COLUMN-_o23occSTg", - "TABS-CslNeIC6x8", - "TAB-t54frVKlx" - ], - "type": "ROW" - }, - "ROW-kHj58UJg5N": { - "children": ["COLUMN-RGd6kjW57J", "COLUMN-_o23occSTg"], - "id": "ROW-kHj58UJg5N", - "meta": { "background": "BACKGROUND_TRANSPARENT" }, - "parents": ["ROOT_ID", "TABS-lV0r00f4H1", "TAB-NF3dlrWGS"], - "type": "ROW" - }, - "TAB-0yhA2SgdPg": { - "children": ["ROW-Gr9YPyQGwf"], - "id": "TAB-0yhA2SgdPg", - "meta": { - "defaultText": "Tab title", - "placeholder": "Tab title", - "text": "Level 2 nested tab 1" - }, - "parents": [ - "ROOT_ID", - "TABS-lV0r00f4H1", - "TAB-NF3dlrWGS", - "TABS-CSjo6VfNrj", - "TAB-z81Q87PD7", - "ROW-G73z9PIHn", - "COLUMN-V6vsdWdOEJ", - "TABS-urzRuDRusW" - ], - "type": "TAB" - }, - "TAB-3a1Gvm-Ef": { - "children": [], - "id": "TAB-3a1Gvm-Ef", - "meta": { - "defaultText": "Tab title", - "placeholder": "Tab title", - "text": "Level 2 nested tab 2" - }, - "parents": [ - "ROOT_ID", - "TABS-lV0r00f4H1", - "TAB-NF3dlrWGS", - "TABS-CSjo6VfNrj", - "TAB-z81Q87PD7", - "ROW-G73z9PIHn", - "COLUMN-V6vsdWdOEJ", - "TABS-urzRuDRusW" - ], - "type": "TAB" - }, - "TAB-EcNm_wh922": { - "children": ["ROW-LCjsdSetJ"], - "id": "TAB-EcNm_wh922", - "meta": { "text": "row tab 1" }, - "parents": [ - "ROOT_ID", - "TABS-lV0r00f4H1", - "TAB-NF3dlrWGS", - "TABS-CSjo6VfNrj" - ], - "type": "TAB" - }, - "TAB-NF3dlrWGS": { - "children": ["ROW-kHj58UJg5N", "TABS-CSjo6VfNrj"], - "id": "TAB-NF3dlrWGS", - "meta": { "text": "Tab A" }, - "parents": ["ROOT_ID", "TABS-lV0r00f4H1"], - "type": "TAB" - }, - "TAB-SDz1jDqYZ2": { - "children": ["ROW-DnYkJgKQE"], - "id": "TAB-SDz1jDqYZ2", - "meta": { - "defaultText": "Tab title", - "placeholder": "Tab title", - "text": "Nested tab 1" - }, - "parents": [ - "ROOT_ID", - "TABS-lV0r00f4H1", - "TAB-NF3dlrWGS", - "ROW-kHj58UJg5N", - "COLUMN-_o23occSTg", - "TABS-CslNeIC6x8" - ], - "type": "TAB" - }, - "TAB-gcQJxApOZS": { - "children": ["TABS-afnrUvdxYF"], - "id": "TAB-gcQJxApOZS", - "meta": { "text": "Tab B" }, - "parents": ["ROOT_ID", "TABS-lV0r00f4H1"], - "type": "TAB" - }, - "TAB-jNNd4WWar1": { - "children": ["ROW-7ygtDczaQ", "ROW-7ygtD666Q"], - "id": "TAB-jNNd4WWar1", - "meta": { "text": "New Tab" }, - "parents": [ - "ROOT_ID", - "TABS-lV0r00f4H1", - "TAB-gcQJxApOZS", - "TABS-afnrUvdxYF" - ], - "type": "TAB" - }, - "TAB-t54frVKlx": { - "children": ["ROW-ghqEVzr2fA"], - "id": "TAB-t54frVKlx", - "meta": { - "defaultText": "Tab title", - "placeholder": "Tab title", - "text": "Nested tab 2" - }, - "parents": [ - "ROOT_ID", - "TABS-lV0r00f4H1", - "TAB-NF3dlrWGS", - "ROW-kHj58UJg5N", - "COLUMN-_o23occSTg", - "TABS-CslNeIC6x8" - ], - "type": "TAB" - }, - "TAB-z81Q87PD7": { - "children": ["ROW-G73z9PIHn"], - "id": "TAB-z81Q87PD7", - "meta": { "text": "row tab 2" }, - "parents": [ - "ROOT_ID", - "TABS-lV0r00f4H1", - "TAB-NF3dlrWGS", - "TABS-CSjo6VfNrj" - ], - "type": "TAB" - }, - "TABS-CSjo6VfNrj": { - "children": ["TAB-EcNm_wh922", "TAB-z81Q87PD7"], - "id": "TABS-CSjo6VfNrj", - "meta": {}, - "parents": ["ROOT_ID", "TABS-lV0r00f4H1", "TAB-NF3dlrWGS"], - "type": "TABS" - }, - "TABS-CslNeIC6x8": { - "children": ["TAB-SDz1jDqYZ2", "TAB-t54frVKlx"], - "id": "TABS-CslNeIC6x8", - "meta": {}, - "parents": [ - "ROOT_ID", - "TABS-lV0r00f4H1", - "TAB-NF3dlrWGS", - "ROW-kHj58UJg5N", - "COLUMN-_o23occSTg" - ], - "type": "TABS" - }, - "TABS-afnrUvdxYF": { - "children": ["TAB-jNNd4WWar1"], - "id": "TABS-afnrUvdxYF", - "meta": {}, - "parents": ["ROOT_ID", "TABS-lV0r00f4H1", "TAB-gcQJxApOZS"], - "type": "TABS" - }, - "TABS-lV0r00f4H1": { - "children": ["TAB-NF3dlrWGS", "TAB-gcQJxApOZS"], - "id": "TABS-lV0r00f4H1", - "meta": {}, - "parents": ["ROOT_ID"], - "type": "TABS" - }, - "TABS-urzRuDRusW": { - "children": ["TAB-0yhA2SgdPg", "TAB-3a1Gvm-Ef"], - "id": "TABS-urzRuDRusW", - "meta": {}, - "parents": [ - "ROOT_ID", - "TABS-lV0r00f4H1", - "TAB-NF3dlrWGS", - "TABS-CSjo6VfNrj", - "TAB-z81Q87PD7", - "ROW-G73z9PIHn", - "COLUMN-V6vsdWdOEJ" - ], - "type": "TABS" - }, - "CHART-p4_VUp8w3w": { - "type": "CHART", - "id": "CHART-p4_VUp8w3w", - "children": [], - "parents": [ - "ROOT_ID", - "TABS-lV0r00f4H1", - "TAB-NF3dlrWGS", - "TABS-CSjo6VfNrj", - "TAB-z81Q87PD7", - "ROW-G73z9PIHn", - "COLUMN-V6vsdWdOEJ", - "TABS-urzRuDRusW", - "TAB-0yhA2SgdPg", - "ROW-Gr9YPyQGwf" - ], - "meta": { - "width": 4, - "height": 20, - "chartId": 614, - "sliceName": "Number of California Births" - } - }, - "ROW-Gr9YPyQGwf": { - "type": "ROW", - "id": "ROW-Gr9YPyQGwf", - "children": ["CHART-p4_VUp8w3w"], - "parents": [ - "ROOT_ID", - "TABS-lV0r00f4H1", - "TAB-NF3dlrWGS", - "TABS-CSjo6VfNrj", - "TAB-z81Q87PD7", - "ROW-G73z9PIHn", - "COLUMN-V6vsdWdOEJ", - "TABS-urzRuDRusW", - "TAB-0yhA2SgdPg" - ], - "meta": { "background": "BACKGROUND_TRANSPARENT" } - } -}""" - ) - pos = json.loads(js) - slices = update_slice_ids(pos) - dash.position_json = json.dumps(pos, indent=4) - dash.slices = slices - dash.dashboard_title = "Tabbed Dashboard" - dash.slug = slug diff --git a/superset/examples/configs/charts/Unicode Test/Unicode_Cloud.test.yaml b/superset/examples/usa_births_names/charts/Boy_Name_Cloud.yaml similarity index 68% rename from superset/examples/configs/charts/Unicode Test/Unicode_Cloud.test.yaml rename to superset/examples/usa_births_names/charts/Boy_Name_Cloud.yaml index 5c60d8789b3..cee8ecf10d2 100644 --- a/superset/examples/configs/charts/Unicode Test/Unicode_Cloud.test.yaml +++ b/superset/examples/usa_births_names/charts/Boy_Name_Cloud.yaml @@ -14,27 +14,34 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Unicode Cloud -viz_type: word_cloud +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 14f48794-ebfa-4f60-a26a-582c49132f1b +description: null params: - granularity_sqla: dttm + adhoc_filters: + - clause: WHERE + comparator: boy + expressionType: SIMPLE + operator: == + subject: gender + compare_lag: '10' + compare_suffix: o10Y + granularity_sqla: ds groupby: [] limit: '100' - metric: - aggregate: SUM - column: - column_name: value - expressionType: SIMPLE - label: Value + markup_type: markdown + metric: sum__num rotation: square row_limit: 50000 - series: short_phrase - since: 100 years ago + series: name size_from: '10' size_to: '70' - until: now + time_range: '100 years ago : now' viz_type: word_cloud -cache_timeout: null -uuid: 609e26d8-8e1e-4097-9751-931708e24ee4 +query_context: null +slice_name: Boy Name Cloud +uuid: d5dfa616-9542-4012-a5bc-9270985f471e version: 1.0.0 -dataset_uuid: a6771c73-96fc-44c6-8b6e-9d303955ea48 +viz_type: word_cloud diff --git a/superset/examples/usa_births_names/charts/Boys.yaml b/superset/examples/usa_births_names/charts/Boys.yaml new file mode 100644 index 00000000000..0b486c17dda --- /dev/null +++ b/superset/examples/usa_births_names/charts/Boys.yaml @@ -0,0 +1,46 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 14f48794-ebfa-4f60-a26a-582c49132f1b +description: null +params: + adhoc_filters: + - clause: WHERE + comparator: boy + expressionType: SIMPLE + operator: == + subject: gender + compare_lag: '10' + compare_suffix: o10Y + granularity_sqla: ds + groupby: + - name + limit: '25' + markup_type: markdown + metrics: + - sum__num + row_limit: 50 + time_range: '100 years ago : now' + timeseries_limit_metric: sum__num + viz_type: table +query_context: null +slice_name: Boys +uuid: 2a58a195-f5eb-4a08-a061-cbe49168eb24 +version: 1.0.0 +viz_type: table diff --git a/superset/examples/configs/charts/COVID Vaccines/Vaccine_Candidates_per_Country.yaml b/superset/examples/usa_births_names/charts/Genders.yaml similarity index 63% rename from superset/examples/configs/charts/COVID Vaccines/Vaccine_Candidates_per_Country.yaml rename to superset/examples/usa_births_names/charts/Genders.yaml index 83c8cf4bcaf..95ebc5b6548 100644 --- a/superset/examples/configs/charts/COVID Vaccines/Vaccine_Candidates_per_Country.yaml +++ b/superset/examples/usa_births_names/charts/Genders.yaml @@ -14,26 +14,25 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Vaccine Candidates per Country -viz_type: treemap_v2 -params: - adhoc_filters: [] - color_scheme: presetColors - datasource: 69__table - groupby: - - country_name - label_colors: {} - metric: count - number_format: SMART_NUMBER - queryFields: - groupby: groupby - metrics: metrics - row_limit: 10000 - time_range: No filter - treemap_ratio: 1.618033988749895 - url_params: {} - viz_type: treemap_v2 cache_timeout: null -uuid: e2f5a8a7-feb0-4f79-bc6b-01fe55b98b3c +certification_details: null +certified_by: null +dataset_uuid: 14f48794-ebfa-4f60-a26a-582c49132f1b +description: null +params: + compare_lag: '10' + compare_suffix: o10Y + granularity_sqla: ds + groupby: + - gender + limit: '25' + markup_type: markdown + metric: sum__num + row_limit: 50000 + time_range: '100 years ago : now' + viz_type: pie +query_context: null +slice_name: Genders +uuid: 7460bdcb-4963-4f1e-9b61-4bbf609273c1 version: 1.0.0 -dataset_uuid: 974b7a1c-22ea-49cb-9214-97b7dbd511e0 +viz_type: pie diff --git a/superset/examples/usa_births_names/charts/Genders_by_State.yaml b/superset/examples/usa_births_names/charts/Genders_by_State.yaml new file mode 100644 index 00000000000..a446f002c96 --- /dev/null +++ b/superset/examples/usa_births_names/charts/Genders_by_State.yaml @@ -0,0 +1,60 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 14f48794-ebfa-4f60-a26a-582c49132f1b +description: null +params: + adhoc_filters: + - clause: WHERE + comparator: + - other + expressionType: SIMPLE + filterOptionName: 2745eae5 + operator: NOT IN + subject: state + compare_lag: '10' + compare_suffix: o10Y + granularity_sqla: ds + groupby: + - state + limit: '25' + markup_type: markdown + metrics: + - aggregate: SUM + column: + column_name: num_boys + type: BIGINT(20) + expressionType: SIMPLE + label: Boys + optionName: metric_11 + - aggregate: SUM + column: + column_name: num_girls + type: BIGINT(20) + expressionType: SIMPLE + label: Girls + optionName: metric_12 + row_limit: 50000 + time_range: '100 years ago : now' + viz_type: echarts_timeseries_bar +query_context: null +slice_name: Genders by State +uuid: b092147d-6068-41b5-a4a4-acc789ce5ebe +version: 1.0.0 +viz_type: echarts_timeseries_bar diff --git a/superset/examples/usa_births_names/charts/Girl_Name_Cloud.yaml b/superset/examples/usa_births_names/charts/Girl_Name_Cloud.yaml new file mode 100644 index 00000000000..d286dafc01e --- /dev/null +++ b/superset/examples/usa_births_names/charts/Girl_Name_Cloud.yaml @@ -0,0 +1,47 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 14f48794-ebfa-4f60-a26a-582c49132f1b +description: null +params: + adhoc_filters: + - clause: WHERE + comparator: girl + expressionType: SIMPLE + operator: == + subject: gender + compare_lag: '10' + compare_suffix: o10Y + granularity_sqla: ds + groupby: [] + limit: '100' + markup_type: markdown + metric: sum__num + rotation: square + row_limit: 50000 + series: name + size_from: '10' + size_to: '70' + time_range: '100 years ago : now' + viz_type: word_cloud +query_context: null +slice_name: Girl Name Cloud +uuid: 19eb5db6-5ec5-4f18-b3c8-b66a035e430d +version: 1.0.0 +viz_type: word_cloud diff --git a/superset/examples/usa_births_names/charts/Girls.yaml b/superset/examples/usa_births_names/charts/Girls.yaml new file mode 100644 index 00000000000..4c63870419a --- /dev/null +++ b/superset/examples/usa_births_names/charts/Girls.yaml @@ -0,0 +1,46 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 14f48794-ebfa-4f60-a26a-582c49132f1b +description: null +params: + adhoc_filters: + - clause: WHERE + comparator: girl + expressionType: SIMPLE + operator: == + subject: gender + compare_lag: '10' + compare_suffix: o10Y + granularity_sqla: ds + groupby: + - name + limit: '25' + markup_type: markdown + metrics: + - sum__num + row_limit: 50 + time_range: '100 years ago : now' + timeseries_limit_metric: sum__num + viz_type: table +query_context: null +slice_name: Girls +uuid: 13be7d94-ead6-465e-97ef-a5d419621c29 +version: 1.0.0 +viz_type: table diff --git a/superset/examples/configs/charts/COVID Vaccines/Vaccine_Candidates_per_Country__Stage.yaml b/superset/examples/usa_births_names/charts/Participants.yaml similarity index 60% rename from superset/examples/configs/charts/COVID Vaccines/Vaccine_Candidates_per_Country__Stage.yaml rename to superset/examples/usa_births_names/charts/Participants.yaml index ea9d4c67ef2..c2ec5a6f060 100644 --- a/superset/examples/configs/charts/COVID Vaccines/Vaccine_Candidates_per_Country__Stage.yaml +++ b/superset/examples/usa_births_names/charts/Participants.yaml @@ -14,27 +14,24 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Vaccine Candidates per Country & Stage -viz_type: sunburst_v2 -params: - adhoc_filters: [] - color_scheme: supersetColors - datasource: 69__table - columns: - - product_category - - clinical_stage - linear_color_scheme: schemeYlOrBr - metric: count - queryFields: - groupby: groupby - metric: metrics - secondary_metric: metrics - row_limit: 10000 - slice_id: 3964 - time_range: No filter - url_params: {} - viz_type: sunburst_v2 cache_timeout: null -uuid: f69c556f-15fe-4a82-a8bb-69d5b6954123 +certification_details: null +certified_by: null +dataset_uuid: 14f48794-ebfa-4f60-a26a-582c49132f1b +description: null +params: + compare_lag: '5' + compare_suffix: over 5Y + granularity_sqla: ds + groupby: [] + limit: '25' + markup_type: markdown + metric: sum__num + row_limit: 50000 + time_range: '100 years ago : now' + viz_type: big_number +query_context: null +slice_name: Participants +uuid: a20d8fff-79b1-4419-83bf-3080f93d6908 version: 1.0.0 -dataset_uuid: 974b7a1c-22ea-49cb-9214-97b7dbd511e0 +viz_type: big_number diff --git a/superset/examples/configs/charts/COVID Vaccines/Vaccine_Candidates_per_Phase_587.yaml b/superset/examples/usa_births_names/charts/Pivot_Table_v2.yaml similarity index 62% rename from superset/examples/configs/charts/COVID Vaccines/Vaccine_Candidates_per_Phase_587.yaml rename to superset/examples/usa_births_names/charts/Pivot_Table_v2.yaml index 906327ff660..2821da9a4cc 100644 --- a/superset/examples/configs/charts/COVID Vaccines/Vaccine_Candidates_per_Phase_587.yaml +++ b/superset/examples/usa_births_names/charts/Pivot_Table_v2.yaml @@ -14,26 +14,29 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Vaccine Candidates per Phase -viz_type: echarts_timeseries_bar -params: - x_axis: clinical_stage - adhoc_filters: [] - bottom_margin: auto - color_scheme: SUPERSET_DEFAULT - columns: [] - datasource: 14__table - label_colors: {} - metrics: - - count - row_limit: 10000 - show_legend: false - time_range: No filter - url_params: {} - viz_type: echarts_timeseries_bar - x_ticks_layout: auto - y_axis_format: SMART_NUMBER cache_timeout: null -uuid: 392f293e-0892-4316-bd41-c927b65606a4 +certification_details: null +certified_by: null +dataset_uuid: 14f48794-ebfa-4f60-a26a-582c49132f1b +description: null +params: + compare_lag: '10' + compare_suffix: o10Y + granularity_sqla: ds + groupby: [] + groupbyColumns: + - state + groupbyRows: + - name + limit: '25' + markup_type: markdown + metrics: + - sum__num + row_limit: 50000 + time_range: '100 years ago : now' + viz_type: pivot_table_v2 +query_context: null +slice_name: Pivot Table v2 +uuid: 4c4561b5-20a5-4011-86f7-31c6d4ecc2ef version: 1.0.0 -dataset_uuid: 974b7a1c-22ea-49cb-9214-97b7dbd511e0 +viz_type: pivot_table_v2 diff --git a/superset/examples/usa_births_names/charts/Top_10_Boy_Name_Share.yaml b/superset/examples/usa_births_names/charts/Top_10_Boy_Name_Share.yaml new file mode 100644 index 00000000000..f31b95b5613 --- /dev/null +++ b/superset/examples/usa_births_names/charts/Top_10_Boy_Name_Share.yaml @@ -0,0 +1,55 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 14f48794-ebfa-4f60-a26a-582c49132f1b +description: null +params: + adhoc_filters: + - clause: WHERE + comparator: boy + expressionType: SIMPLE + operator: == + subject: gender + compare_lag: '10' + compare_suffix: o10Y + comparison_type: values + granularity_sqla: ds + groupby: + - name + limit: 10 + markup_type: markdown + metrics: + - aggregate: SUM + column: + column_name: num + type: BIGINT + expressionType: SIMPLE + label: Births + optionName: metric_11 + row_limit: 50000 + stacked_style: expand + time_grain_sqla: P1D + time_range: '100 years ago : now' + viz_type: echarts_area + x_axis_forma: smart_date +query_context: null +slice_name: Top 10 Boy Name Share +uuid: 26a9bde8-eb06-4de3-91f0-5e04d448403a +version: 1.0.0 +viz_type: echarts_area diff --git a/superset/examples/usa_births_names/charts/Top_10_Girl_Name_Share.yaml b/superset/examples/usa_births_names/charts/Top_10_Girl_Name_Share.yaml new file mode 100644 index 00000000000..b9b60cc38f2 --- /dev/null +++ b/superset/examples/usa_births_names/charts/Top_10_Girl_Name_Share.yaml @@ -0,0 +1,55 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 14f48794-ebfa-4f60-a26a-582c49132f1b +description: null +params: + adhoc_filters: + - clause: WHERE + comparator: girl + expressionType: SIMPLE + operator: == + subject: gender + compare_lag: '10' + compare_suffix: o10Y + comparison_type: values + granularity_sqla: ds + groupby: + - name + limit: 10 + markup_type: markdown + metrics: + - aggregate: SUM + column: + column_name: num + type: BIGINT + expressionType: SIMPLE + label: Births + optionName: metric_11 + row_limit: 50000 + stacked_style: expand + time_grain_sqla: P1D + time_range: '100 years ago : now' + viz_type: echarts_area + x_axis_forma: smart_date +query_context: null +slice_name: Top 10 Girl Name Share +uuid: 44c4c16f-216d-44c8-b033-6876b8c51fd2 +version: 1.0.0 +viz_type: echarts_area diff --git a/superset/examples/usa_births_names/charts/Trends.yaml b/superset/examples/usa_births_names/charts/Trends.yaml new file mode 100644 index 00000000000..0d7877f216f --- /dev/null +++ b/superset/examples/usa_births_names/charts/Trends.yaml @@ -0,0 +1,47 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 14f48794-ebfa-4f60-a26a-582c49132f1b +description: null +params: + compare_lag: '10' + compare_suffix: o10Y + granularity_sqla: ds + groupby: + - name + limit: '25' + markup_type: markdown + metrics: + - aggregate: SUM + column: + column_name: num + type: BIGINT + expressionType: SIMPLE + label: Births + optionName: metric_11 + rich_tooltip: true + row_limit: 50000 + show_legend: true + time_range: '100 years ago : now' + viz_type: echarts_timeseries_line +query_context: null +slice_name: Trends +uuid: e7f37c36-35b4-45f5-a323-9c1d1ff69d04 +version: 1.0.0 +viz_type: echarts_timeseries_line diff --git a/superset/examples/usa_births_names/dashboard.yaml b/superset/examples/usa_births_names/dashboard.yaml new file mode 100644 index 00000000000..962b35520bd --- /dev/null +++ b/superset/examples/usa_births_names/dashboard.yaml @@ -0,0 +1,265 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +certification_details: null +certified_by: null +css: null +dashboard_title: USA Births Names +description: null +metadata: + chart_configuration: {} + color_scheme: '' + color_scheme_domain: [] + cross_filters_enabled: false + default_filters: '{}' + expanded_slices: {} + global_chart_configuration: {} + label_colors: + Boys: '#ADD8E6' + Girls: '#FF69B4' + boy: '#ADD8E6' + girl: '#FF69B4' + map_label_colors: {} + native_filter_configuration: [] + refresh_frequency: 0 + shared_label_colors: [] + timed_refresh_immune_slices: [] +position: + CHART-6GdlekVise: + children: [] + id: CHART-6GdlekVise + meta: + chartId: 140 + height: 50 + sliceName: Top 10 Girl Name Share + uuid: 44c4c16f-216d-44c8-b033-6876b8c51fd2 + width: 5 + parents: + - ROOT_ID + - GRID_ID + - ROW-eh0w37bWbR + type: CHART + CHART-6n9jxb30JG: + children: [] + id: CHART-6n9jxb30JG + meta: + chartId: 135 + height: 36 + sliceName: Genders by State + uuid: b092147d-6068-41b5-a4a4-acc789ce5ebe + width: 5 + parents: + - ROOT_ID + - GRID_ID + - ROW--EyBZQlDi + type: CHART + CHART-Jj9qh1ol-N: + children: [] + id: CHART-Jj9qh1ol-N + meta: + chartId: 139 + height: 50 + sliceName: Boy Name Cloud + uuid: d5dfa616-9542-4012-a5bc-9270985f471e + width: 4 + parents: + - ROOT_ID + - GRID_ID + - ROW-kzWtcvo8R1 + type: CHART + CHART-ODvantb_bF: + children: [] + id: CHART-ODvantb_bF + meta: + chartId: 141 + height: 50 + sliceName: Top 10 Boy Name Share + uuid: 26a9bde8-eb06-4de3-91f0-5e04d448403a + width: 5 + parents: + - ROOT_ID + - GRID_ID + - ROW-kzWtcvo8R1 + type: CHART + CHART-PAXUUqwmX9: + children: [] + id: CHART-PAXUUqwmX9 + meta: + chartId: 133 + height: 34 + sliceName: Genders + uuid: 7460bdcb-4963-4f1e-9b61-4bbf609273c1 + width: 3 + parents: + - ROOT_ID + - GRID_ID + - ROW-2n0XgiHDgs + type: CHART + CHART-_T6n_K9iQN: + children: [] + id: CHART-_T6n_K9iQN + meta: + chartId: 134 + height: 36 + sliceName: Trends + uuid: e7f37c36-35b4-45f5-a323-9c1d1ff69d04 + width: 7 + parents: + - ROOT_ID + - GRID_ID + - ROW--EyBZQlDi + type: CHART + CHART-eNY0tcE_ic: + children: [] + id: CHART-eNY0tcE_ic + meta: + chartId: 132 + height: 34 + sliceName: Participants + uuid: a20d8fff-79b1-4419-83bf-3080f93d6908 + width: 3 + parents: + - ROOT_ID + - GRID_ID + - ROW-2n0XgiHDgs + type: CHART + CHART-g075mMgyYb: + children: [] + id: CHART-g075mMgyYb + meta: + chartId: 136 + height: 50 + sliceName: Girls + uuid: 13be7d94-ead6-465e-97ef-a5d419621c29 + width: 3 + parents: + - ROOT_ID + - GRID_ID + - ROW-eh0w37bWbR + type: CHART + CHART-n-zGGE6S1y: + children: [] + id: CHART-n-zGGE6S1y + meta: + chartId: 137 + height: 50 + sliceName: Girl Name Cloud + uuid: 19eb5db6-5ec5-4f18-b3c8-b66a035e430d + width: 4 + parents: + - ROOT_ID + - GRID_ID + - ROW-eh0w37bWbR + type: CHART + CHART-vJIPjmcbD3: + children: [] + id: CHART-vJIPjmcbD3 + meta: + chartId: 138 + height: 50 + sliceName: Boys + uuid: 2a58a195-f5eb-4a08-a061-cbe49168eb24 + width: 3 + parents: + - ROOT_ID + - GRID_ID + - ROW-kzWtcvo8R1 + type: CHART + DASHBOARD_VERSION_KEY: v2 + GRID_ID: + children: + - ROW-2n0XgiHDgs + - ROW--EyBZQlDi + - ROW-eh0w37bWbR + - ROW-kzWtcvo8R1 + id: GRID_ID + parents: + - ROOT_ID + type: GRID + HEADER_ID: + id: HEADER_ID + meta: + text: Births + type: HEADER + MARKDOWN-zaflB60tbC: + children: [] + id: MARKDOWN-zaflB60tbC + meta: + code:

Birth Names Dashboard

+ height: 34 + width: 6 + parents: + - ROOT_ID + - GRID_ID + - ROW-2n0XgiHDgs + type: MARKDOWN + ROOT_ID: + children: + - GRID_ID + id: ROOT_ID + type: ROOT + ROW--EyBZQlDi: + children: + - CHART-_T6n_K9iQN + - CHART-6n9jxb30JG + id: ROW--EyBZQlDi + meta: + background: BACKGROUND_TRANSPARENT + parents: + - ROOT_ID + - GRID_ID + type: ROW + ROW-2n0XgiHDgs: + children: + - CHART-eNY0tcE_ic + - MARKDOWN-zaflB60tbC + - CHART-PAXUUqwmX9 + id: ROW-2n0XgiHDgs + meta: + background: BACKGROUND_TRANSPARENT + parents: + - ROOT_ID + - GRID_ID + type: ROW + ROW-eh0w37bWbR: + children: + - CHART-g075mMgyYb + - CHART-n-zGGE6S1y + - CHART-6GdlekVise + id: ROW-eh0w37bWbR + meta: + background: BACKGROUND_TRANSPARENT + parents: + - ROOT_ID + - GRID_ID + type: ROW + ROW-kzWtcvo8R1: + children: + - CHART-vJIPjmcbD3 + - CHART-Jj9qh1ol-N + - CHART-ODvantb_bF + id: ROW-kzWtcvo8R1 + meta: + background: BACKGROUND_TRANSPARENT + parents: + - ROOT_ID + - GRID_ID + type: ROW +published: true +slug: births +uuid: 02543e07-662c-46be-bb04-fe5afbe1a86c +version: 1.0.0 diff --git a/superset/examples/usa_births_names/data.parquet b/superset/examples/usa_births_names/data.parquet new file mode 100644 index 00000000000..ae79b86448b Binary files /dev/null and b/superset/examples/usa_births_names/data.parquet differ diff --git a/superset/examples/usa_births_names/dataset.yaml b/superset/examples/usa_births_names/dataset.yaml new file mode 100644 index 00000000000..3d29bc69101 --- /dev/null +++ b/superset/examples/usa_births_names/dataset.yaml @@ -0,0 +1,153 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +always_filter_main_dttm: false +cache_timeout: null +catalog: null +columns: +- advanced_data_type: null + column_name: num_california + description: null + expression: CASE WHEN state = 'CA' THEN num ELSE 0 END + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: null + verbose_name: null +- advanced_data_type: null + column_name: ds + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: true + python_date_format: null + type: TIMESTAMP WITHOUT TIME ZONE + verbose_name: null +- advanced_data_type: null + column_name: gender + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: name + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: num + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: state + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: num_boys + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: num_girls + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +data_file: data.parquet +database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee +default_endpoint: null +description: null +extra: null +fetch_values_predicate: null +filter_select_enabled: true +folders: null +main_dttm_col: ds +metrics: +- currency: null + d3format: null + description: null + expression: COUNT(*) + extra: null + metric_name: count + metric_type: count + verbose_name: COUNT(*) + warning_text: null +- currency: null + d3format: null + description: null + expression: SUM(num) + extra: null + metric_name: sum__num + metric_type: null + verbose_name: null + warning_text: null +normalize_columns: false +offset: 0 +params: null +schema: null +sql: null +table_name: birth_names +template_params: null +uuid: 14f48794-ebfa-4f60-a26a-582c49132f1b +version: 1.0.0 diff --git a/superset/examples/utils.py b/superset/examples/utils.py index d5da9c7c530..8b7a8c1e87f 100644 --- a/superset/examples/utils.py +++ b/superset/examples/utils.py @@ -31,11 +31,167 @@ _logger = logging.getLogger(__name__) YAML_EXTENSIONS = {".yaml", ".yml"} +def _normalize_dataset_schema(content: str) -> str: + """Normalize schema in dataset YAML content. + + Converts SQLite's 'main' schema to null for portability across databases. + """ + # Replace 'schema: main' with 'schema: null' to use target database default + return content.replace("schema: main", "schema: null") + + +def _read_file_if_exists(base: Any, path: Any) -> str | None: + """Read file content if it exists, return None otherwise.""" + file_path = base / str(path) + if file_path.is_file(): + return file_path.read_text("utf-8") + return None + + +def _load_shared_configs(examples_root: Any) -> dict[str, str]: + """Load shared database and metadata configs from _shared directory.""" + from flask import current_app + + contents: dict[str, str] = {} + base = files("superset") + shared_dir = examples_root / "_shared" + + if not (base / str(shared_dir)).is_dir(): + return contents + + # Database config -> databases/examples.yaml + if db_content := _read_file_if_exists(base, shared_dir / "database.yaml"): + # Replace placeholder with configured examples URI + examples_uri = current_app.config.get("SQLALCHEMY_EXAMPLES_URI", "") + db_content = db_content.replace("__SQLALCHEMY_EXAMPLES_URI__", examples_uri) + contents["databases/examples.yaml"] = db_content + + # Metadata -> metadata.yaml + if meta_content := _read_file_if_exists(base, shared_dir / "metadata.yaml"): + contents["metadata.yaml"] = meta_content + + return contents + + +def _should_skip_directory(item: Any) -> bool: + """Check if directory should be skipped during traversal.""" + name = str(item) + if name.startswith("_") or name.startswith("."): + return True + return name in ("configs", "data", "__pycache__") + + +def _load_datasets_from_folder( + base: Any, + datasets_dir: Any, + test_re: re.Pattern[str], + load_test_data: bool, +) -> dict[str, str]: + """Load dataset configs from a datasets/ folder.""" + contents: dict[str, str] = {} + if not (base / str(datasets_dir)).is_dir(): + return contents + + for dataset_item in (base / str(datasets_dir)).iterdir(): + dataset_filename = dataset_item.name # Get just the filename, not full path + if Path(dataset_filename).suffix.lower() not in YAML_EXTENSIONS: + continue + if not load_test_data and test_re.search(dataset_filename): + continue + dataset_file = datasets_dir / dataset_filename + content = _read_file_if_exists(base, dataset_file) + if content: + dataset_name = Path(dataset_filename).stem + contents[f"datasets/examples/{dataset_name}.yaml"] = ( + _normalize_dataset_schema(content) + ) + return contents + + +def _load_charts_from_folder( + base: Any, + charts_dir: Any, + example_name: str, + test_re: re.Pattern[str], + load_test_data: bool, +) -> dict[str, str]: + """Load chart configs from a charts/ folder.""" + contents: dict[str, str] = {} + if not (base / str(charts_dir)).is_dir(): + return contents + + for chart_item in (base / str(charts_dir)).iterdir(): + chart_name = chart_item.name # Get just the filename, not full path + if Path(chart_name).suffix.lower() not in YAML_EXTENSIONS: + continue + if not load_test_data and test_re.search(chart_name): + continue + chart_file = charts_dir / chart_name + content = _read_file_if_exists(base, chart_file) + if content: + contents[f"charts/{example_name}/{chart_name}"] = content + return contents + + +def _load_example_contents( + example_dir: Any, example_name: str, test_re: re.Pattern[str], load_test_data: bool +) -> dict[str, str]: + """Load all configs (dataset, dashboard, charts) from a single example directory.""" + contents: dict[str, str] = {} + base = files("superset") + + # Single dataset.yaml at root (backward compatible) + dataset_content = _read_file_if_exists(base, example_dir / "dataset.yaml") + if dataset_content and (load_test_data or not test_re.search("dataset.yaml")): + contents[f"datasets/examples/{example_name}.yaml"] = _normalize_dataset_schema( + dataset_content + ) + + # Multiple datasets in datasets/ folder + contents.update( + _load_datasets_from_folder( + base, example_dir / "datasets", test_re, load_test_data + ) + ) + + # Dashboard config + dashboard_content = _read_file_if_exists(base, example_dir / "dashboard.yaml") + if dashboard_content and (load_test_data or not test_re.search("dashboard.yaml")): + contents[f"dashboards/{example_name}.yaml"] = dashboard_content + + # Chart configs + contents.update( + _load_charts_from_folder( + base, example_dir / "charts", example_name, test_re, load_test_data + ) + ) + + return contents + + def load_examples_from_configs( force_data: bool = False, load_test_data: bool = False ) -> None: """ - Load all the examples inside superset/examples/configs/. + Load all the examples from the new directory structure. + + Examples are organized as: + superset/examples/{example_name}/ + data.parquet # Raw data (optional) + dataset.yaml # Single dataset metadata (simple examples) + datasets/ # Multiple datasets (complex examples) + dataset1.yaml + dataset2.yaml + dashboard.yaml # Dashboard config (optional) + charts/ # Chart configs (optional) + chart1.yaml + chart2.yaml + superset/examples/_shared/ + database.yaml # Database connection + metadata.yaml # Import metadata + + For simple examples with one dataset, use dataset.yaml at root. + For complex examples with multiple datasets, use datasets/ folder. """ contents = load_contents(load_test_data) command = ImportExamplesCommand(contents, overwrite=True, force_data=force_data) @@ -43,31 +199,45 @@ def load_examples_from_configs( def load_contents(load_test_data: bool = False) -> dict[str, Any]: - """Traverse configs directory and load contents""" - root = files("superset") / "examples/configs" - resource_names = (files("superset") / str(root)).iterdir() - queue = [root / str(resource_name) for resource_name in resource_names] + """Traverse example directories and load YAML configs. - contents: dict[Path, str] = {} - while queue: - path_name = queue.pop() - test_re = re.compile(r"\.test\.|metadata\.yaml$") + Builds import structure expected by ImportExamplesCommand: + databases/examples.yaml + datasets/examples/{name}.yaml + charts/{dashboard}/{chart}.yaml + dashboards/{name}.yaml + metadata.yaml - if (files("superset") / str(path_name)).is_dir(): - queue.extend( - path_name / str(child_name) - for child_name in (files("superset") / str(path_name)).iterdir() - ) - elif Path(str(path_name)).suffix.lower() in YAML_EXTENSIONS: - if load_test_data and test_re.search(str(path_name)) is None: - continue - contents[Path(str(path_name))] = ( - files("superset") / str(path_name) - ).read_text("utf-8") + Args: + load_test_data: If True, includes test data files (*.test.yaml). + If False, excludes test data files. + """ + examples_root = files("superset") / "examples" + test_re = re.compile(r"\.test\.") + base = files("superset") - return { - str(path.relative_to(str(root))): content for path, content in contents.items() - } + # Load shared configs (_shared directory) + contents: dict[str, str] = _load_shared_configs(examples_root) + + # Traverse example directories + for item in (base / str(examples_root)).iterdir(): + item_name = item.name # Get just the directory name, not full path + example_dir = examples_root / item_name + + # Skip non-directories and special dirs + if not (base / str(example_dir)).is_dir(): + continue + if _should_skip_directory(item_name): + continue + + example_name = item_name + + example_contents = _load_example_contents( + example_dir, example_name, test_re, load_test_data + ) + contents.update(example_contents) + + return contents def load_configs_from_directory( diff --git a/superset/examples/configs/charts/Video Game Sales/Games.yaml b/superset/examples/video_game_sales/charts/Games.yaml similarity index 94% rename from superset/examples/configs/charts/Video Game Sales/Games.yaml rename to superset/examples/video_game_sales/charts/Games.yaml index 6a7112292e7..f26743957c2 100644 --- a/superset/examples/configs/charts/Video Game Sales/Games.yaml +++ b/superset/examples/video_game_sales/charts/Games.yaml @@ -14,8 +14,11 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Games -viz_type: table +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 53d47c0c-c03d-47f0-b9ac-81225f808283 +description: null params: adhoc_filters: [] all_columns: @@ -25,6 +28,7 @@ params: - genre - publisher - year + annotation_layers: [] color_pn: false datasource: 21__table granularity_sqla: year @@ -69,7 +73,8 @@ params: time_range: No filter url_params: {} viz_type: table -cache_timeout: null +query_context: null +slice_name: Games uuid: 2a5e562b-ab37-1b9b-1de3-1be4335c8e83 version: 1.0.0 -dataset_uuid: 53d47c0c-c03d-47f0-b9ac-81225f808283 +viz_type: table diff --git a/superset/examples/configs/charts/Video Game Sales/Games_per_Genre.yaml b/superset/examples/video_game_sales/charts/Games_per_Genre.yaml similarity index 51% rename from superset/examples/configs/charts/Video Game Sales/Games_per_Genre.yaml rename to superset/examples/video_game_sales/charts/Games_per_Genre.yaml index 0d29cc85d6e..07743ce7e63 100644 --- a/superset/examples/configs/charts/Video Game Sales/Games_per_Genre.yaml +++ b/superset/examples/video_game_sales/charts/Games_per_Genre.yaml @@ -14,68 +14,72 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Games per Genre -viz_type: treemap_v2 +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 53d47c0c-c03d-47f0-b9ac-81225f808283 +description: null params: adhoc_filters: [] + annotation_layers: [] color_scheme: supersetColors datasource: 1559__table granularity_sqla: year groupby: - - genre + - genre label_colors: - "0": "#1FA8C9" - "1": "#454E7C" - "2600": "#666666" - 3DO: "#B2B2B2" - 3DS: "#D1C6BC" - Action: "#1FA8C9" - Adventure: "#454E7C" - DC: "#A38F79" - DS: "#8FD3E4" - Europe: "#5AC189" - Fighting: "#5AC189" - GB: "#FDE380" - GBA: "#ACE1C4" - GC: "#5AC189" - GEN: "#3CCCCB" - GG: "#EFA1AA" - Japan: "#FF7F44" - Microsoft Game Studios: "#D1C6BC" - Misc: "#FF7F44" - N64: "#1FA8C9" - NES: "#9EE5E5" - NG: "#A1A6BD" - Nintendo: "#D3B3DA" - North America: "#666666" - Other: "#E04355" - PC: "#EFA1AA" - PCFX: "#FDE380" - PS: "#A1A6BD" - PS2: "#FCC700" - PS3: "#3CCCCB" - PS4: "#B2B2B2" - PSP: "#FEC0A1" - PSV: "#FCC700" - Platform: "#666666" - Puzzle: "#E04355" - Racing: "#FCC700" - Role-Playing: "#A868B7" - SAT: "#A868B7" - SCD: "#8FD3E4" - SNES: "#454E7C" - Shooter: "#3CCCCB" - Simulation: "#A38F79" - Sports: "#8FD3E4" - Strategy: "#A1A6BD" - TG16: "#FEC0A1" - Take-Two Interactive: "#9EE5E5" - WS: "#ACE1C4" - Wii: "#A38F79" - WiiU: "#E04355" - X360: "#A868B7" - XB: "#D3B3DA" - XOne: "#FF7F44" + '0': '#1FA8C9' + '1': '#454E7C' + '2600': '#666666' + 3DO: '#B2B2B2' + 3DS: '#D1C6BC' + Action: '#1FA8C9' + Adventure: '#454E7C' + DC: '#A38F79' + DS: '#8FD3E4' + Europe: '#5AC189' + Fighting: '#5AC189' + GB: '#FDE380' + GBA: '#ACE1C4' + GC: '#5AC189' + GEN: '#3CCCCB' + GG: '#EFA1AA' + Japan: '#FF7F44' + Microsoft Game Studios: '#D1C6BC' + Misc: '#FF7F44' + N64: '#1FA8C9' + NES: '#9EE5E5' + NG: '#A1A6BD' + Nintendo: '#D3B3DA' + North America: '#666666' + Other: '#E04355' + PC: '#EFA1AA' + PCFX: '#FDE380' + PS: '#A1A6BD' + PS2: '#FCC700' + PS3: '#3CCCCB' + PS4: '#B2B2B2' + PSP: '#FEC0A1' + PSV: '#FCC700' + Platform: '#666666' + Puzzle: '#E04355' + Racing: '#FCC700' + Role-Playing: '#A868B7' + SAT: '#A868B7' + SCD: '#8FD3E4' + SNES: '#454E7C' + Shooter: '#3CCCCB' + Simulation: '#A38F79' + Sports: '#8FD3E4' + Strategy: '#A1A6BD' + TG16: '#FEC0A1' + Take-Two Interactive: '#9EE5E5' + WS: '#ACE1C4' + Wii: '#A38F79' + WiiU: '#E04355' + X360: '#A868B7' + XB: '#D3B3DA' + XOne: '#FF7F44' metric: count number_format: SMART_NUMBER queryFields: @@ -85,11 +89,11 @@ params: time_range: No filter treemap_ratio: 1.618033988749895 url_params: - preselect_filters: - '{"1389": {"platform": ["PS", "PS2", "PS3", "PS4"], "genre": + preselect_filters: '{"1389": {"platform": ["PS", "PS2", "PS3", "PS4"], "genre": null, "__time_range": "No filter"}}' viz_type: treemap_v2 -cache_timeout: null +query_context: null +slice_name: Games per Genre uuid: 0499bdec-0837-44f3-ae8a-8c670de81afd version: 1.0.0 -dataset_uuid: 53d47c0c-c03d-47f0-b9ac-81225f808283 +viz_type: treemap_v2 diff --git a/superset/examples/configs/charts/Video Game Sales/Most_Dominant_Platforms.yaml b/superset/examples/video_game_sales/charts/Most_Dominant_Platforms.yaml similarity index 95% rename from superset/examples/configs/charts/Video Game Sales/Most_Dominant_Platforms.yaml rename to superset/examples/video_game_sales/charts/Most_Dominant_Platforms.yaml index 12b00279002..06542ca8687 100644 --- a/superset/examples/configs/charts/Video Game Sales/Most_Dominant_Platforms.yaml +++ b/superset/examples/video_game_sales/charts/Most_Dominant_Platforms.yaml @@ -14,8 +14,11 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Most Dominant Platforms -viz_type: pie +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 53d47c0c-c03d-47f0-b9ac-81225f808283 +description: null params: adhoc_filters: - clause: WHERE @@ -27,6 +30,7 @@ params: operator: <= sqlExpression: null subject: rank + annotation_layers: [] color_scheme: supersetColors datasource: 21__table donut: true @@ -35,6 +39,7 @@ params: - publisher innerRadius: 45 label_line: true + label_type: key labels_outside: true metric: aggregate: SUM @@ -58,7 +63,6 @@ params: sqlExpression: null number_format: SMART_NUMBER outerRadius: 67 - label_type: key queryFields: groupby: groupby metric: metrics @@ -69,7 +73,8 @@ params: time_range: No filter url_params: {} viz_type: pie -cache_timeout: null +query_context: null +slice_name: Most Dominant Platforms uuid: 1810975a-f6d4-07c3-495c-c3b535d01f21 version: 1.0.0 -dataset_uuid: 53d47c0c-c03d-47f0-b9ac-81225f808283 +viz_type: pie diff --git a/superset/examples/configs/charts/Video Game Sales/Popular_Genres_Across_Platforms.yaml b/superset/examples/video_game_sales/charts/Popular_Genres_Across_Platforms.yaml similarity index 92% rename from superset/examples/configs/charts/Video Game Sales/Popular_Genres_Across_Platforms.yaml rename to superset/examples/video_game_sales/charts/Popular_Genres_Across_Platforms.yaml index f73b29c8350..a617868f64f 100644 --- a/superset/examples/configs/charts/Video Game Sales/Popular_Genres_Across_Platforms.yaml +++ b/superset/examples/video_game_sales/charts/Popular_Genres_Across_Platforms.yaml @@ -14,15 +14,18 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Popular Genres Across Platforms -viz_type: heatmap_v2 +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 53d47c0c-c03d-47f0-b9ac-81225f808283 +description: null params: adhoc_filters: [] - x_axis: platform - groupby: genre + annotation_layers: [] bottom_margin: auto datasource: 64__table granularity_sqla: year + groupby: genre left_margin: auto linear_color_scheme: blue_white_yellow metric: count @@ -37,14 +40,16 @@ params: sort_y_axis: alpha_asc time_range: No filter url_params: {} - viz_type: heatmap_v2 - xscale_interval: null value_bounds: - - null - - null + - null + - null + viz_type: heatmap_v2 + x_axis: platform + xscale_interval: null y_axis_format: SMART_NUMBER yscale_interval: null -cache_timeout: null +query_context: null +slice_name: Popular Genres Across Platforms uuid: 326fc7e5-b7f1-448e-8a6f-80d0e7ce0b64 version: 1.0.0 -dataset_uuid: 53d47c0c-c03d-47f0-b9ac-81225f808283 +viz_type: heatmap_v2 diff --git a/superset/examples/configs/charts/Video Game Sales/Publishers_With_Most_Titles.yaml b/superset/examples/video_game_sales/charts/Publishers_With_Most_Titles.yaml similarity index 93% rename from superset/examples/configs/charts/Video Game Sales/Publishers_With_Most_Titles.yaml rename to superset/examples/video_game_sales/charts/Publishers_With_Most_Titles.yaml index 0cb790545fd..b95be0ccaaf 100644 --- a/superset/examples/configs/charts/Video Game Sales/Publishers_With_Most_Titles.yaml +++ b/superset/examples/video_game_sales/charts/Publishers_With_Most_Titles.yaml @@ -14,8 +14,11 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Publishers With Most Titles -viz_type: table +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 53d47c0c-c03d-47f0-b9ac-81225f808283 +description: null params: adhoc_filters: [] all_columns: @@ -26,6 +29,7 @@ params: - genre - publisher - year + annotation_layers: [] color_pn: false datasource: 21__table granularity_sqla: year @@ -48,7 +52,8 @@ params: time_range: No filter url_params: {} viz_type: table -cache_timeout: null +query_context: null +slice_name: Publishers With Most Titles uuid: d20b7324-3b80-24d4-37e2-3bd583b66713 version: 1.0.0 -dataset_uuid: 53d47c0c-c03d-47f0-b9ac-81225f808283 +viz_type: table diff --git a/superset/examples/video_game_sales/charts/Top_10_Games_Proportion_of_Sales_in_Markets.yaml b/superset/examples/video_game_sales/charts/Top_10_Games_Proportion_of_Sales_in_Markets.yaml new file mode 100644 index 00000000000..6dbcc7bda59 --- /dev/null +++ b/superset/examples/video_game_sales/charts/Top_10_Games_Proportion_of_Sales_in_Markets.yaml @@ -0,0 +1,137 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 53d47c0c-c03d-47f0-b9ac-81225f808283 +description: null +params: + adhoc_filters: + - clause: WHERE + comparator: '10' + expressionType: SIMPLE + filterOptionName: filter_juemdnqji5_d6fm8tuf4rc + isExtra: false + isNew: false + operator: <= + sqlExpression: null + subject: rank + annotation_layers: [] + bar_stacked: true + bottom_margin: auto + color_scheme: supersetColors + columns: [] + contribution: true + datasource: 21__table + granularity_sqla: year + groupby: + - name + label_colors: {} + metrics: + - aggregate: SUM + column: + column_name: na_sales + description: null + expression: null + filterable: true + groupby: true + id: 883 + is_dttm: false + optionName: _col_NA_Sales + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null + expressionType: SIMPLE + hasCustomLabel: true + isNew: false + label: North America + optionName: metric_a943v7wg5g_0mm03hrsmpf + sqlExpression: null + - aggregate: SUM + column: + column_name: eu_sales + description: null + expression: null + filterable: true + groupby: true + id: 884 + is_dttm: false + optionName: _col_EU_Sales + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null + expressionType: SIMPLE + hasCustomLabel: true + isNew: false + label: Europe + optionName: metric_bibau54x0rb_dwrjtqkbyso + sqlExpression: null + - aggregate: SUM + column: + column_name: jp_sales + description: null + expression: null + filterable: true + groupby: true + id: 885 + is_dttm: false + optionName: _col_JP_Sales + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null + expressionType: SIMPLE + hasCustomLabel: true + isNew: false + label: Japan + optionName: metric_06whpr2oyhw_4l88xxu6zvd + sqlExpression: null + - aggregate: SUM + column: + column_name: other_sales + description: null + expression: null + filterable: true + groupby: true + id: 886 + is_dttm: false + optionName: _col_Other_Sales + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null + expressionType: SIMPLE + hasCustomLabel: true + isNew: false + label: Other + optionName: metric_pcx05ioxums_ibr16zvi74 + sqlExpression: null + queryFields: + columns: groupby + groupby: groupby + metrics: metrics + row_limit: null + show_legend: true + slice_id: 3546 + time_range: No filter + url_params: {} + viz_type: echarts_timeseries_bar + x_ticks_layout: staggered + y_axis_format: SMART_NUMBER +query_context: null +slice_name: 'Top 10 Games: Proportion of Sales in Markets' +uuid: a40879d5-653a-42fe-9314-bbe88ad26e92 +version: 1.0.0 +viz_type: echarts_timeseries_bar diff --git a/superset/examples/video_game_sales/charts/Total_Sales_per_Market_Grouped_by_Genre.yaml b/superset/examples/video_game_sales/charts/Total_Sales_per_Market_Grouped_by_Genre.yaml new file mode 100644 index 00000000000..e5d2928f66a --- /dev/null +++ b/superset/examples/video_game_sales/charts/Total_Sales_per_Market_Grouped_by_Genre.yaml @@ -0,0 +1,186 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 53d47c0c-c03d-47f0-b9ac-81225f808283 +description: null +params: + adhoc_filters: [] + annotation_layers: [] + bar_stacked: true + bottom_margin: auto + color_scheme: supersetColors + columns: [] + contribution: false + datasource: 21__table + granularity_sqla: year + groupby: + - genre + label_colors: + '0': '#1FA8C9' + '1': '#454E7C' + '2600': '#666666' + 3DO: '#B2B2B2' + 3DS: '#D1C6BC' + Action: '#1FA8C9' + Adventure: '#454E7C' + DC: '#A38F79' + DS: '#8FD3E4' + Europe: '#5AC189' + Fighting: '#5AC189' + GB: '#FDE380' + GBA: '#ACE1C4' + GC: '#5AC189' + GEN: '#3CCCCB' + GG: '#EFA1AA' + Japan: '#FF7F44' + Microsoft Game Studios: '#D1C6BC' + Misc: '#FF7F44' + N64: '#1FA8C9' + NES: '#9EE5E5' + NG: '#A1A6BD' + Nintendo: '#D3B3DA' + North America: '#666666' + Other: '#E04355' + PC: '#EFA1AA' + PCFX: '#FDE380' + PS: '#A1A6BD' + PS2: '#FCC700' + PS3: '#3CCCCB' + PS4: '#B2B2B2' + PSP: '#FEC0A1' + PSV: '#FCC700' + Platform: '#666666' + Puzzle: '#E04355' + Racing: '#FCC700' + Role-Playing: '#A868B7' + SAT: '#A868B7' + SCD: '#8FD3E4' + SNES: '#454E7C' + Shooter: '#3CCCCB' + Simulation: '#A38F79' + Sports: '#8FD3E4' + Strategy: '#A1A6BD' + TG16: '#FEC0A1' + Take-Two Interactive: '#9EE5E5' + WS: '#ACE1C4' + Wii: '#A38F79' + WiiU: '#E04355' + X360: '#A868B7' + XB: '#D3B3DA' + XOne: '#FF7F44' + metrics: + - aggregate: SUM + column: + column_name: na_sales + description: null + expression: null + filterable: true + groupby: true + id: 883 + is_dttm: false + optionName: _col_NA_Sales + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null + expressionType: SIMPLE + hasCustomLabel: true + isNew: false + label: North America + optionName: metric_3pl6jwmyd72_p9o4j2xxgyp + sqlExpression: null + - aggregate: SUM + column: + column_name: eu_sales + description: null + expression: null + filterable: true + groupby: true + id: 884 + is_dttm: false + optionName: _col_EU_Sales + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null + expressionType: SIMPLE + hasCustomLabel: true + isNew: false + label: Europe + optionName: metric_e8rdyfxxjdu_6dgyhf7xcne + sqlExpression: null + - aggregate: SUM + column: + column_name: jp_sales + description: null + expression: null + filterable: true + groupby: true + id: 885 + is_dttm: false + optionName: _col_JP_Sales + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null + expressionType: SIMPLE + hasCustomLabel: true + isNew: false + label: Japan + optionName: metric_6gesefugzy6_517l3wowdwu + sqlExpression: null + - aggregate: SUM + column: + column_name: other_sales + description: null + expression: null + filterable: true + groupby: true + id: 886 + is_dttm: false + optionName: _col_Other_Sales + python_date_format: null + type: DOUBLE PRECISION + verbose_name: null + expressionType: SIMPLE + hasCustomLabel: true + isNew: false + label: Other + optionName: metric_cf6kbre28f_2sg5b5pfq5a + sqlExpression: null + order_bars: false + queryFields: + columns: groupby + groupby: groupby + metrics: metrics + row_limit: null + show_bar_value: false + show_controls: true + show_legend: true + slice_id: 3548 + time_range: No filter + url_params: + preselect_filters: '{"1389": {"platform": ["PS", "PS2", "PS3", "PS4"], "genre": + null, "__time_range": "No filter"}}' + viz_type: echarts_timeseries_bar + x_axis_label: Genre + x_ticks_layout: flat + y_axis_format: SMART_NUMBER +query_context: null +slice_name: Total Sales per Market (Grouped by Genre) +uuid: d8bf948e-46fd-4380-9f9c-a950c34bcc92 +version: 1.0.0 +viz_type: echarts_timeseries_bar diff --git a/superset/examples/configs/charts/Video Game Sales/Number_of_Games_That_Hit_100k_in_Sales_By_Release_Year.yaml b/superset/examples/video_game_sales/charts/of_Games_That_Hit_100k_in_Sales_By_Release_Year.yaml similarity index 52% rename from superset/examples/configs/charts/Video Game Sales/Number_of_Games_That_Hit_100k_in_Sales_By_Release_Year.yaml rename to superset/examples/video_game_sales/charts/of_Games_That_Hit_100k_in_Sales_By_Release_Year.yaml index adfef546c27..10574f05820 100644 --- a/superset/examples/configs/charts/Video Game Sales/Number_of_Games_That_Hit_100k_in_Sales_By_Release_Year.yaml +++ b/superset/examples/video_game_sales/charts/of_Games_That_Hit_100k_in_Sales_By_Release_Year.yaml @@ -14,63 +14,67 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: "# of Games That Hit 100k in Sales By Release Year" -viz_type: treemap_v2 +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 53d47c0c-c03d-47f0-b9ac-81225f808283 +description: null params: adhoc_filters: [] + annotation_layers: [] color_scheme: supersetColors datasource: 21__table granularity_sqla: year groupby: - - platform + - platform label_colors: - "2600": "#D1C6BC" - 3DO: "#A38F79" - 3DS: "#B2B2B2" - Action: "#ACE1C4" - Adventure: "#5AC189" - COUNT(*): "#1FA8C9" - DC: "#666666" - DS: "#E04355" - Fighting: "#D1C6BC" - GB: "#A1A6BD" - GBA: "#A868B7" - GC: "#D3B3DA" - GEN: "#FF7F44" - GG: "#8FD3E4" - Microsoft Game Studios: "#FCC700" - Misc: "#D3B3DA" - N64: "#EFA1AA" - NES: "#FEC0A1" - NG: "#FCC700" - Nintendo: "#666666" - PC: "#8FD3E4" - PCFX: "#A1A6BD" - PS: "#FCC700" - PS2: "#454E7C" - PS3: "#FF7F44" - PS4: "#A38F79" - PSP: "#3CCCCB" - PSV: "#454E7C" - Platform: "#FDE380" - Puzzle: "#454E7C" - Racing: "#9EE5E5" - Role-Playing: "#EFA1AA" - SAT: "#5AC189" - SCD: "#E04355" - SNES: "#FDE380" - Shooter: "#B2B2B2" - Simulation: "#1FA8C9" - Sports: "#FEC0A1" - Strategy: "#FF7F44" - TG16: "#3CCCCB" - Take-Two Interactive: "#E04355" - WS: "#A868B7" - Wii: "#666666" - WiiU: "#1FA8C9" - X360: "#5AC189" - XB: "#ACE1C4" - XOne: "#9EE5E5" + '2600': '#D1C6BC' + 3DO: '#A38F79' + 3DS: '#B2B2B2' + Action: '#ACE1C4' + Adventure: '#5AC189' + COUNT(*): '#1FA8C9' + DC: '#666666' + DS: '#E04355' + Fighting: '#D1C6BC' + GB: '#A1A6BD' + GBA: '#A868B7' + GC: '#D3B3DA' + GEN: '#FF7F44' + GG: '#8FD3E4' + Microsoft Game Studios: '#FCC700' + Misc: '#D3B3DA' + N64: '#EFA1AA' + NES: '#FEC0A1' + NG: '#FCC700' + Nintendo: '#666666' + PC: '#8FD3E4' + PCFX: '#A1A6BD' + PS: '#FCC700' + PS2: '#454E7C' + PS3: '#FF7F44' + PS4: '#A38F79' + PSP: '#3CCCCB' + PSV: '#454E7C' + Platform: '#FDE380' + Puzzle: '#454E7C' + Racing: '#9EE5E5' + Role-Playing: '#EFA1AA' + SAT: '#5AC189' + SCD: '#E04355' + SNES: '#FDE380' + Shooter: '#B2B2B2' + Simulation: '#1FA8C9' + Sports: '#FEC0A1' + Strategy: '#FF7F44' + TG16: '#3CCCCB' + Take-Two Interactive: '#E04355' + WS: '#A868B7' + Wii: '#666666' + WiiU: '#1FA8C9' + X360: '#5AC189' + XB: '#ACE1C4' + XOne: '#9EE5E5' metric: count number_format: SMART_NUMBER queryFields: @@ -82,7 +86,8 @@ params: treemap_ratio: 1.618033988749895 url_params: {} viz_type: treemap_v2 -cache_timeout: null +query_context: null +slice_name: '# of Games That Hit 100k in Sales By Release Year' uuid: 2b69887b-23e3-b46d-d38c-8ea11856c555 version: 1.0.0 -dataset_uuid: 53d47c0c-c03d-47f0-b9ac-81225f808283 +viz_type: treemap_v2 diff --git a/superset/examples/configs/dashboards/Video_Game_Sales.yaml b/superset/examples/video_game_sales/dashboard.yaml similarity index 55% rename from superset/examples/configs/dashboards/Video_Game_Sales.yaml rename to superset/examples/video_game_sales/dashboard.yaml index 2edaad2d1a8..5d3c415b544 100644 --- a/superset/examples/configs/dashboards/Video_Game_Sales.yaml +++ b/superset/examples/video_game_sales/dashboard.yaml @@ -14,157 +14,220 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. +certification_details: '' +certified_by: '' +css: '' dashboard_title: Video Game Sales description: null -css: "" -slug: null -certified_by: "" -certification_details: "" -published: true -uuid: c7bc10f4-6a2d-7569-caae-bbc91864ee11 +metadata: + chart_configuration: {} + color_scheme: supersetColors + color_scheme_domain: [] + cross_filters_enabled: false + default_filters: '{}' + expanded_slices: {} + global_chart_configuration: {} + label_colors: + '0': '#1FA8C9' + '1': '#454E7C' + '2600': '#666666' + 3DO: '#B2B2B2' + 3DS: '#D1C6BC' + Action: '#1FA8C9' + Adventure: '#454E7C' + DC: '#A38F79' + DS: '#8FD3E4' + Europe: '#5AC189' + Fighting: '#5AC189' + GB: '#FDE380' + GBA: '#ACE1C4' + GC: '#5AC189' + GEN: '#3CCCCB' + GG: '#EFA1AA' + Japan: '#FF7F44' + Microsoft Game Studios: '#D1C6BC' + Misc: '#FF7F44' + N64: '#1FA8C9' + NES: '#9EE5E5' + NG: '#A1A6BD' + Nintendo: '#D3B3DA' + North America: '#666666' + Other: '#E04355' + PC: '#EFA1AA' + PCFX: '#FDE380' + PS: '#A1A6BD' + PS2: '#FCC700' + PS3: '#3CCCCB' + PS4: '#B2B2B2' + PSP: '#FEC0A1' + PSV: '#FCC700' + Platform: '#666666' + Puzzle: '#E04355' + Racing: '#FCC700' + Role-Playing: '#A868B7' + SAT: '#A868B7' + SCD: '#8FD3E4' + SNES: '#454E7C' + Shooter: '#3CCCCB' + Simulation: '#A38F79' + Sports: '#8FD3E4' + Strategy: '#A1A6BD' + TG16: '#FEC0A1' + Take-Two Interactive: '#9EE5E5' + WS: '#ACE1C4' + Wii: '#A38F79' + WiiU: '#E04355' + X360: '#A868B7' + XB: '#D3B3DA' + XOne: '#FF7F44' + map_label_colors: {} + native_filter_configuration: [] + refresh_frequency: 0 + shared_label_colors: [] + timed_refresh_immune_slices: [] position: CHART-7mKdnU7OUJ: children: [] id: CHART-7mKdnU7OUJ meta: - chartId: 3545 + chartId: 57 height: 55 sliceName: Games per Genre uuid: 0499bdec-0837-44f3-ae8a-8c670de81afd width: 8 parents: - - ROOT_ID - - TABS-97PVJa11D_ - - TAB-2_QXp8aNq - - ROW-yP9SB89PZ + - ROOT_ID + - TABS-97PVJa11D_ + - TAB-2_QXp8aNq + - ROW-yP9SB89PZ type: CHART CHART-8OG3UJX-Tn: children: [] id: CHART-8OG3UJX-Tn meta: - chartId: 661 + chartId: 65 height: 54 - sliceName: "# of Games That Hit 100k in Sales By Release Year" - sliceNameOverride: "Top 10 Consoles, by # of Hit Games" + sliceName: '# of Games That Hit 100k in Sales By Release Year' + sliceNameOverride: 'Top 10 Consoles, by # of Hit Games' uuid: 2b69887b-23e3-b46d-d38c-8ea11856c555 width: 6 parents: - - ROOT_ID - - TABS-97PVJa11D_ - - TAB-lg-5ymUDgm - - ROW-7kAf1blYU + - ROOT_ID + - TABS-97PVJa11D_ + - TAB-lg-5ymUDgm + - ROW-7kAf1blYU type: CHART CHART-W02beJK7ms: children: [] id: CHART-W02beJK7ms meta: - chartId: 657 + chartId: 60 height: 54 sliceName: Publishers With Most Titles sliceNameOverride: Top 10 Games (by Global Sales) uuid: d20b7324-3b80-24d4-37e2-3bd583b66713 width: 3 parents: - - ROOT_ID - - TABS-97PVJa11D_ - - TAB-lg-5ymUDgm - - ROW-7kAf1blYU + - ROOT_ID + - TABS-97PVJa11D_ + - TAB-lg-5ymUDgm + - ROW-7kAf1blYU type: CHART CHART-XFag0yZdLk: children: [] id: CHART-XFag0yZdLk meta: - chartId: 658 + chartId: 59 height: 54 sliceName: Most Dominant Platforms sliceNameOverride: Publishers of Top 25 Games uuid: 1810975a-f6d4-07c3-495c-c3b535d01f21 width: 3 parents: - - ROOT_ID - - TABS-97PVJa11D_ - - TAB-lg-5ymUDgm - - ROW-7kAf1blYU + - ROOT_ID + - TABS-97PVJa11D_ + - TAB-lg-5ymUDgm + - ROW-7kAf1blYU type: CHART CHART-XRvRfsMsaQ: children: [] id: CHART-XRvRfsMsaQ meta: - chartId: 3546 + chartId: 61 height: 62 - sliceName: "Top 10 Games: Proportion of Sales in Markets" + sliceName: 'Top 10 Games: Proportion of Sales in Markets' uuid: a40879d5-653a-42fe-9314-bbe88ad26e92 width: 6 parents: - - ROOT_ID - - TABS-97PVJa11D_ - - TAB-lg-5ymUDgm - - ROW-NuR8GFQTO + - ROOT_ID + - TABS-97PVJa11D_ + - TAB-lg-5ymUDgm + - ROW-NuR8GFQTO type: CHART CHART-XVIYTeubZh: children: [] id: CHART-XVIYTeubZh meta: - chartId: 1394 + chartId: 62 height: 80 sliceName: Games uuid: 2a5e562b-ab37-1b9b-1de3-1be4335c8e83 width: 6 parents: - - ROOT_ID - - TABS-97PVJa11D_ - - TAB-2_QXp8aNq - - ROW-yP9SB89PZ + - ROOT_ID + - TABS-97PVJa11D_ + - TAB-2_QXp8aNq + - ROW-yP9SB89PZ type: CHART CHART-_sx22yawJO: children: [] id: CHART-_sx22yawJO meta: - chartId: 3461 + chartId: 58 height: 62 sliceName: Popular Genres Across Platforms uuid: 326fc7e5-b7f1-448e-8a6f-80d0e7ce0b64 width: 6 parents: - - ROOT_ID - - TABS-97PVJa11D_ - - TAB-lg-5ymUDgm - - ROW-NuR8GFQTO + - ROOT_ID + - TABS-97PVJa11D_ + - TAB-lg-5ymUDgm + - ROW-NuR8GFQTO type: CHART CHART-nYns6xr4Ft: children: [] id: CHART-nYns6xr4Ft meta: - chartId: 3548 + chartId: 64 height: 80 sliceName: Total Sales per Market (Grouped by Genre) uuid: d8bf948e-46fd-4380-9f9c-a950c34bcc92 width: 6 parents: - - ROOT_ID - - TABS-97PVJa11D_ - - TAB-2_QXp8aNq - - ROW-fjg6YQBkH + - ROOT_ID + - TABS-97PVJa11D_ + - TAB-2_QXp8aNq + - ROW-fjg6YQBkH type: CHART COLUMN-F53B1OSMcz: children: - - MARKDOWN-7K5cBNy7qu + - MARKDOWN-7K5cBNy7qu id: COLUMN-F53B1OSMcz meta: background: BACKGROUND_TRANSPARENT width: 4 parents: - - ROOT_ID - - TABS-97PVJa11D_ - - TAB-2_QXp8aNq - - ROW-yP9SB89PZ + - ROOT_ID + - TABS-97PVJa11D_ + - TAB-2_QXp8aNq + - ROW-yP9SB89PZ type: COLUMN DASHBOARD_VERSION_KEY: v2 GRID_ID: children: [] id: GRID_ID parents: - - ROOT_ID + - ROOT_ID type: GRID HEADER_ID: id: HEADER_ID @@ -175,8 +238,7 @@ position: children: [] id: MARKDOWN-7K5cBNy7qu meta: - code: - "# \U0001F93F Explore Trends\n\nDive into data on popular video games\ + code: "# \U0001F93F Explore Trends\n\nDive into data on popular video games\ \ using the following dimensions:\n\n- Year\n- Platform\n- Publisher\n- Genre\n\ \nTo use the **Filter Games** box below, select values for each dimension\ \ you want to zoom in on and then click **Apply**. \n\nThe filter criteria\ @@ -184,185 +246,133 @@ position: height: 55 width: 4 parents: - - ROOT_ID - - TABS-97PVJa11D_ - - TAB-2_QXp8aNq - - ROW-yP9SB89PZ - - COLUMN-F53B1OSMcz + - ROOT_ID + - TABS-97PVJa11D_ + - TAB-2_QXp8aNq + - ROW-yP9SB89PZ + - COLUMN-F53B1OSMcz type: MARKDOWN MARKDOWN-JOZKOjVc3a: children: [] id: MARKDOWN-JOZKOjVc3a meta: - code: - "## \U0001F3AEVideo Game Sales\n\nThis dashboard visualizes sales & platform\ - \ data on video games that sold more than 100k copies. The data was last updated\ - \ in early 2017.\n\n[Original dataset](https://www.kaggle.com/gregorut/videogamesales)" + code: '## 🎮Video Game Sales + + + This dashboard visualizes sales & platform data on video games that sold more + than 100k copies. The data was last updated in early 2017. + + + [Original dataset](https://www.kaggle.com/gregorut/videogamesales)' height: 18 width: 12 parents: - - ROOT_ID - - TABS-97PVJa11D_ - - TAB-lg-5ymUDgm - - ROW-0F99WDC-sz + - ROOT_ID + - TABS-97PVJa11D_ + - TAB-lg-5ymUDgm + - ROW-0F99WDC-sz type: MARKDOWN ROOT_ID: children: - - TABS-97PVJa11D_ + - TABS-97PVJa11D_ id: ROOT_ID type: ROOT ROW-0F99WDC-sz: children: - - MARKDOWN-JOZKOjVc3a + - MARKDOWN-JOZKOjVc3a id: ROW-0F99WDC-sz meta: background: BACKGROUND_TRANSPARENT parents: - - ROOT_ID - - TABS-97PVJa11D_ - - TAB-lg-5ymUDgm + - ROOT_ID + - TABS-97PVJa11D_ + - TAB-lg-5ymUDgm type: ROW ROW-7kAf1blYU: children: - - CHART-W02beJK7ms - - CHART-XFag0yZdLk - - CHART-8OG3UJX-Tn + - CHART-W02beJK7ms + - CHART-XFag0yZdLk + - CHART-8OG3UJX-Tn id: ROW-7kAf1blYU meta: - "0": ROOT_ID + '0': ROOT_ID background: BACKGROUND_TRANSPARENT parents: - - ROOT_ID - - TABS-97PVJa11D_ - - TAB-lg-5ymUDgm + - ROOT_ID + - TABS-97PVJa11D_ + - TAB-lg-5ymUDgm type: ROW ROW-NuR8GFQTO: children: - - CHART-_sx22yawJO - - CHART-XRvRfsMsaQ + - CHART-_sx22yawJO + - CHART-XRvRfsMsaQ id: ROW-NuR8GFQTO meta: - "0": ROOT_ID - "1": TABS-97PVJa11D_ + '0': ROOT_ID + '1': TABS-97PVJa11D_ background: BACKGROUND_TRANSPARENT parents: - - ROOT_ID - - TABS-97PVJa11D_ - - TAB-lg-5ymUDgm + - ROOT_ID + - TABS-97PVJa11D_ + - TAB-lg-5ymUDgm type: ROW ROW-fjg6YQBkH: children: - - CHART-nYns6xr4Ft - - CHART-XVIYTeubZh + - CHART-nYns6xr4Ft + - CHART-XVIYTeubZh id: ROW-fjg6YQBkH meta: background: BACKGROUND_TRANSPARENT parents: - - ROOT_ID - - TABS-97PVJa11D_ - - TAB-2_QXp8aNq + - ROOT_ID + - TABS-97PVJa11D_ + - TAB-2_QXp8aNq type: ROW ROW-yP9SB89PZ: children: - - COLUMN-F53B1OSMcz - - CHART-7mKdnU7OUJ + - COLUMN-F53B1OSMcz + - CHART-7mKdnU7OUJ id: ROW-yP9SB89PZ meta: background: BACKGROUND_TRANSPARENT parents: - - ROOT_ID - - TABS-97PVJa11D_ - - TAB-2_QXp8aNq + - ROOT_ID + - TABS-97PVJa11D_ + - TAB-2_QXp8aNq type: ROW TAB-2_QXp8aNq: children: - - ROW-yP9SB89PZ - - ROW-fjg6YQBkH + - ROW-yP9SB89PZ + - ROW-fjg6YQBkH id: TAB-2_QXp8aNq meta: - text: "\U0001F93F Explore Trends" + text: 🤿 Explore Trends parents: - - ROOT_ID - - TABS-97PVJa11D_ + - ROOT_ID + - TABS-97PVJa11D_ type: TAB TAB-lg-5ymUDgm: children: - - ROW-0F99WDC-sz - - ROW-7kAf1blYU - - ROW-NuR8GFQTO + - ROW-0F99WDC-sz + - ROW-7kAf1blYU + - ROW-NuR8GFQTO id: TAB-lg-5ymUDgm meta: text: Overview parents: - - ROOT_ID - - TABS-97PVJa11D_ + - ROOT_ID + - TABS-97PVJa11D_ type: TAB TABS-97PVJa11D_: children: - - TAB-lg-5ymUDgm - - TAB-2_QXp8aNq + - TAB-lg-5ymUDgm + - TAB-2_QXp8aNq id: TABS-97PVJa11D_ meta: {} parents: - - ROOT_ID + - ROOT_ID type: TABS -metadata: - timed_refresh_immune_slices: [] - expanded_slices: {} - refresh_frequency: 0 - default_filters: "{}" - color_scheme: supersetColors - label_colors: - "0": "#1FA8C9" - "1": "#454E7C" - "2600": "#666666" - Europe: "#5AC189" - Japan: "#FF7F44" - North America: "#666666" - Other: "#E04355" - PS2: "#FCC700" - X360: "#A868B7" - PS3: "#3CCCCB" - Wii: "#A38F79" - DS: "#8FD3E4" - PS: "#A1A6BD" - GBA: "#ACE1C4" - PSP: "#FEC0A1" - PS4: "#B2B2B2" - PC: "#EFA1AA" - GB: "#FDE380" - XB: "#D3B3DA" - NES: "#9EE5E5" - 3DS: "#D1C6BC" - N64: "#1FA8C9" - SNES: "#454E7C" - GC: "#5AC189" - XOne: "#FF7F44" - WiiU: "#E04355" - PSV: "#FCC700" - SAT: "#A868B7" - GEN: "#3CCCCB" - DC: "#A38F79" - SCD: "#8FD3E4" - NG: "#A1A6BD" - WS: "#ACE1C4" - TG16: "#FEC0A1" - 3DO: "#B2B2B2" - GG: "#EFA1AA" - PCFX: "#FDE380" - Nintendo: "#D3B3DA" - Take-Two Interactive: "#9EE5E5" - Microsoft Game Studios: "#D1C6BC" - Action: "#1FA8C9" - Adventure: "#454E7C" - Fighting: "#5AC189" - Misc: "#FF7F44" - Platform: "#666666" - Puzzle: "#E04355" - Racing: "#FCC700" - Role-Playing: "#A868B7" - Shooter: "#3CCCCB" - Simulation: "#A38F79" - Sports: "#8FD3E4" - Strategy: "#A1A6BD" +published: true +slug: null +uuid: c7bc10f4-6a2d-7569-caae-bbc91864ee11 version: 1.0.0 diff --git a/superset/examples/video_game_sales/data.parquet b/superset/examples/video_game_sales/data.parquet new file mode 100644 index 00000000000..efd27cd9b32 Binary files /dev/null and b/superset/examples/video_game_sales/data.parquet differ diff --git a/superset/examples/video_game_sales/dataset.yaml b/superset/examples/video_game_sales/dataset.yaml new file mode 100644 index 00000000000..e0630a750ae --- /dev/null +++ b/superset/examples/video_game_sales/dataset.yaml @@ -0,0 +1,180 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +always_filter_main_dttm: false +cache_timeout: null +catalog: null +columns: +- advanced_data_type: null + column_name: year + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: true + python_date_format: '%Y' + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: na_sales + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: FLOAT64 + verbose_name: null +- advanced_data_type: null + column_name: eu_sales + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: FLOAT64 + verbose_name: null +- advanced_data_type: null + column_name: global_sales + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: FLOAT64 + verbose_name: null +- advanced_data_type: null + column_name: jp_sales + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: FLOAT64 + verbose_name: null +- advanced_data_type: null + column_name: other_sales + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: FLOAT64 + verbose_name: null +- advanced_data_type: null + column_name: rank + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: BIGINT + verbose_name: null +- advanced_data_type: null + column_name: genre + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: STRING + verbose_name: null +- advanced_data_type: null + column_name: name + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: STRING + verbose_name: null +- advanced_data_type: null + column_name: platform + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: STRING + verbose_name: null +- advanced_data_type: null + column_name: publisher + description: null + expression: null + extra: null + filterable: true + groupby: true + is_active: null + is_dttm: false + python_date_format: null + type: STRING + verbose_name: null +data_file: data.parquet +database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee +default_endpoint: null +description: null +extra: null +fetch_values_predicate: null +filter_select_enabled: true +folders: null +main_dttm_col: null +metrics: +- currency: null + d3format: null + description: null + expression: COUNT(*) + extra: null + metric_name: count + metric_type: null + verbose_name: COUNT(*) + warning_text: null +normalize_columns: false +offset: 0 +params: null +schema: null +sql: null +table_name: video_game_sales +template_params: null +uuid: 53d47c0c-c03d-47f0-b9ac-81225f808283 +version: 1.0.0 diff --git a/superset/examples/configs/charts/COVID Vaccines/Vaccine_Candidates_per_Phase.yaml b/superset/examples/world_health/charts/Box_plot.yaml similarity index 57% rename from superset/examples/configs/charts/COVID Vaccines/Vaccine_Candidates_per_Phase.yaml rename to superset/examples/world_health/charts/Box_plot.yaml index 22c4d911bd5..d9f542eb6e9 100644 --- a/superset/examples/configs/charts/COVID Vaccines/Vaccine_Candidates_per_Phase.yaml +++ b/superset/examples/world_health/charts/Box_plot.yaml @@ -14,33 +14,33 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. -slice_name: Vaccine Candidates per Phase -viz_type: pie -params: - adhoc_filters: [] - color_scheme: supersetColors - datasource: 69__table - donut: true - groupby: - - clinical_stage - innerRadius: 44 - label_line: true - labels_outside: true - metric: count - number_format: SMART_NUMBER - outerRadius: 61 - label_type: key - queryFields: - groupby: groupby - metric: metrics - row_limit: 10000 - show_labels: true - show_legend: false - slice_id: 3957 - time_range: No filter - url_params: {} - viz_type: pie cache_timeout: null -uuid: 30b73c65-85e7-455f-bb24-801bb0cdc670 +certification_details: null +certified_by: null +dataset_uuid: 69e9de42-fe7f-4948-946a-f7913227aee8 +description: null +params: + compare_lag: '10' + compare_suffix: o10Y + country_fieldtype: cca3 + entity: country_code + granularity_sqla: year + groupby: + - region + limit: '25' + markup_type: markdown + metrics: + - sum__SP_POP_TOTL + row_limit: 50000 + show_bubbles: true + since: '1960-01-01' + time_range: '2014-01-01 : 2014-01-02' + until: now + viz_type: box_plot + whisker_options: Min/max (no outliers) + x_ticks_layout: staggered +query_context: null +slice_name: Box plot +uuid: 53c450c6-98bf-435a-8ebb-2a237bccfd09 version: 1.0.0 -dataset_uuid: 974b7a1c-22ea-49cb-9214-97b7dbd511e0 +viz_type: box_plot diff --git a/superset/examples/world_health/charts/Growth_Rate.yaml b/superset/examples/world_health/charts/Growth_Rate.yaml new file mode 100644 index 00000000000..e07f98291f8 --- /dev/null +++ b/superset/examples/world_health/charts/Growth_Rate.yaml @@ -0,0 +1,45 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 69e9de42-fe7f-4948-946a-f7913227aee8 +description: null +params: + compare_lag: '10' + compare_suffix: o10Y + country_fieldtype: cca3 + entity: country_code + granularity_sqla: year + groupby: + - country_name + limit: '25' + markup_type: markdown + metrics: + - sum__SP_POP_TOTL + num_period_compare: '10' + row_limit: 50000 + show_bubbles: true + since: '1960-01-01' + time_range: '2014-01-01 : 2014-01-02' + until: '2014-01-02' + viz_type: echarts_timeseries_line +query_context: null +slice_name: Growth Rate +uuid: 6cf742ee-281a-4673-a37c-587d6f29726a +version: 1.0.0 +viz_type: echarts_timeseries_line diff --git a/superset/examples/world_health/charts/Life_Expectancy_VS_Rural.yaml b/superset/examples/world_health/charts/Life_Expectancy_VS_Rural.yaml new file mode 100644 index 00000000000..07de79bb393 --- /dev/null +++ b/superset/examples/world_health/charts/Life_Expectancy_VS_Rural.yaml @@ -0,0 +1,67 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 69e9de42-fe7f-4948-946a-f7913227aee8 +description: null +params: + adhoc_filters: + - clause: WHERE + comparator: + - TCA + - MNP + - DMA + - MHL + - MCO + - SXM + - CYM + - TUV + - IMY + - KNA + - ASM + - ADO + - AMA + - PLW + expressionType: SIMPLE + filterOptionName: 2745eae5 + operator: NOT IN + subject: country_code + compare_lag: '10' + compare_suffix: o10Y + country_fieldtype: cca3 + entity: country_name + granularity_sqla: year + groupby: [] + limit: 0 + markup_type: markdown + max_bubble_size: '50' + row_limit: 50000 + series: region + show_bubbles: true + since: '2011-01-01' + size: sum__SP_POP_TOTL + time_range: '2014-01-01 : 2014-01-02' + until: '2011-01-02' + viz_type: bubble + x: sum__SP_RUR_TOTL_ZS + y: sum__SP_DYN_LE00_IN +query_context: null +slice_name: Life Expectancy VS Rural % +uuid: c18faec9-ec43-4d36-8b66-4c8b1372020f +version: 1.0.0 +viz_type: bubble diff --git a/superset/examples/world_health/charts/Most_Populated_Countries.yaml b/superset/examples/world_health/charts/Most_Populated_Countries.yaml new file mode 100644 index 00000000000..81c2a81ec1c --- /dev/null +++ b/superset/examples/world_health/charts/Most_Populated_Countries.yaml @@ -0,0 +1,44 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 69e9de42-fe7f-4948-946a-f7913227aee8 +description: null +params: + compare_lag: '10' + compare_suffix: o10Y + country_fieldtype: cca3 + entity: country_code + granularity_sqla: year + groupby: + - country_name + limit: '25' + markup_type: markdown + metrics: + - sum__SP_POP_TOTL + row_limit: 50000 + show_bubbles: true + since: '2014-01-01' + time_range: '2014-01-01 : 2014-01-02' + until: '2014-01-02' + viz_type: table +query_context: null +slice_name: Most Populated Countries +uuid: ef1d1d69-4da6-4654-adc5-c78586b07c92 +version: 1.0.0 +viz_type: table diff --git a/superset/examples/world_health/charts/Rural.yaml b/superset/examples/world_health/charts/Rural.yaml new file mode 100644 index 00000000000..a548be2456e --- /dev/null +++ b/superset/examples/world_health/charts/Rural.yaml @@ -0,0 +1,52 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 69e9de42-fe7f-4948-946a-f7913227aee8 +description: null +params: + compare_lag: '10' + compare_suffix: o10Y + country_fieldtype: cca3 + entity: country_code + granularity_sqla: year + groupby: [] + limit: '25' + markup_type: markdown + metric: sum__SP_RUR_TOTL_ZS + num_period_compare: '10' + row_limit: 50000 + secondary_metric: + aggregate: SUM + column: + column_name: SP_RUR_TOTL + optionName: _col_SP_RUR_TOTL + type: DOUBLE + expressionType: SIMPLE + hasCustomLabel: true + label: Rural Population + show_bubbles: true + since: '2014-01-01' + time_range: '2014-01-01 : 2014-01-02' + until: '2014-01-02' + viz_type: world_map +query_context: null +slice_name: '% Rural' +uuid: ba225b63-1ae2-4bf5-b995-1d83740365c1 +version: 1.0.0 +viz_type: world_map diff --git a/superset/examples/world_health/charts/Rural_Breakdown.yaml b/superset/examples/world_health/charts/Rural_Breakdown.yaml new file mode 100644 index 00000000000..afad630287f --- /dev/null +++ b/superset/examples/world_health/charts/Rural_Breakdown.yaml @@ -0,0 +1,54 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 69e9de42-fe7f-4948-946a-f7913227aee8 +description: null +params: + columns: + - region + - country_name + compare_lag: '10' + compare_suffix: o10Y + country_fieldtype: cca3 + entity: country_code + granularity_sqla: year + groupby: [] + limit: '25' + markup_type: markdown + metric: sum__SP_POP_TOTL + row_limit: 50000 + secondary_metric: + aggregate: SUM + column: + column_name: SP_RUR_TOTL + optionName: _col_SP_RUR_TOTL + type: DOUBLE + expressionType: SIMPLE + hasCustomLabel: true + label: Rural Population + show_bubbles: true + since: '2011-01-01' + time_range: '2014-01-01 : 2014-01-02' + until: '2011-01-02' + viz_type: sunburst_v2 +query_context: null +slice_name: Rural Breakdown +uuid: cdac97d6-28a2-4cff-a1d0-c8b81dcf29a6 +version: 1.0.0 +viz_type: sunburst_v2 diff --git a/superset/examples/world_health/charts/Treemap.yaml b/superset/examples/world_health/charts/Treemap.yaml new file mode 100644 index 00000000000..be14db4b8df --- /dev/null +++ b/superset/examples/world_health/charts/Treemap.yaml @@ -0,0 +1,44 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 69e9de42-fe7f-4948-946a-f7913227aee8 +description: null +params: + compare_lag: '10' + compare_suffix: o10Y + country_fieldtype: cca3 + entity: country_code + granularity_sqla: year + groupby: + - region + - country_code + limit: '25' + markup_type: markdown + metric: sum__SP_POP_TOTL + row_limit: 50000 + show_bubbles: true + since: '1960-01-01' + time_range: '2014-01-01 : 2014-01-02' + until: now + viz_type: treemap_v2 +query_context: null +slice_name: Treemap +uuid: 71a12856-38a5-4978-be65-d0f4fde98aae +version: 1.0.0 +viz_type: treemap_v2 diff --git a/superset/examples/world_health/charts/World_s_Pop_Growth.yaml b/superset/examples/world_health/charts/World_s_Pop_Growth.yaml new file mode 100644 index 00000000000..30abe799d41 --- /dev/null +++ b/superset/examples/world_health/charts/World_s_Pop_Growth.yaml @@ -0,0 +1,44 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 69e9de42-fe7f-4948-946a-f7913227aee8 +description: null +params: + compare_lag: '10' + compare_suffix: o10Y + country_fieldtype: cca3 + entity: country_code + granularity_sqla: year + groupby: + - region + limit: '25' + markup_type: markdown + metrics: + - sum__SP_POP_TOTL + row_limit: 50000 + show_bubbles: true + since: '1960-01-01' + time_range: '2014-01-01 : 2014-01-02' + until: now + viz_type: echarts_area +query_context: null +slice_name: World's Pop Growth +uuid: 6f7e8cc4-c850-4992-85a4-b161a782abc6 +version: 1.0.0 +viz_type: echarts_area diff --git a/superset/examples/world_health/charts/World_s_Population.yaml b/superset/examples/world_health/charts/World_s_Population.yaml new file mode 100644 index 00000000000..a698253bf10 --- /dev/null +++ b/superset/examples/world_health/charts/World_s_Population.yaml @@ -0,0 +1,42 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +cache_timeout: null +certification_details: null +certified_by: null +dataset_uuid: 69e9de42-fe7f-4948-946a-f7913227aee8 +description: null +params: + compare_lag: '10' + compare_suffix: over 10Y + country_fieldtype: cca3 + entity: country_code + granularity_sqla: year + groupby: [] + limit: '25' + markup_type: markdown + metric: sum__SP_POP_TOTL + row_limit: 50000 + show_bubbles: true + since: '2000' + time_range: '2014-01-01 : 2014-01-02' + until: '2014-01-02' + viz_type: big_number +query_context: null +slice_name: World's Population +uuid: 78422cf9-f149-4491-b552-2ab0e3afffcf +version: 1.0.0 +viz_type: big_number diff --git a/superset/examples/world_health/dashboard.yaml b/superset/examples/world_health/dashboard.yaml new file mode 100644 index 00000000000..99b150442f4 --- /dev/null +++ b/superset/examples/world_health/dashboard.yaml @@ -0,0 +1,205 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +certification_details: null +certified_by: null +css: null +dashboard_title: World Bank's Data +description: null +metadata: + chart_configuration: {} + color_scheme: '' + color_scheme_domain: [] + cross_filters_enabled: false + default_filters: '{}' + expanded_slices: {} + global_chart_configuration: {} + label_colors: {} + map_label_colors: {} + native_filter_configuration: [] + refresh_frequency: 0 + shared_label_colors: [] + timed_refresh_immune_slices: [] +position: + CHART-0fd0d252: + children: [] + id: CHART-0fd0d252 + meta: + chartId: 126 + height: 50 + sliceName: Life Expectancy VS Rural % + uuid: c18faec9-ec43-4d36-8b66-4c8b1372020f + width: 8 + type: CHART + CHART-17e0f8d8: + children: [] + id: CHART-17e0f8d8 + meta: + chartId: 123 + height: 92 + sliceName: Most Populated Countries + uuid: ef1d1d69-4da6-4654-adc5-c78586b07c92 + width: 3 + type: CHART + CHART-2d5b6871: + children: [] + id: CHART-2d5b6871 + meta: + chartId: 125 + height: 52 + sliceName: '% Rural' + uuid: ba225b63-1ae2-4bf5-b995-1d83740365c1 + width: 7 + type: CHART + CHART-2ee52f30: + children: [] + id: CHART-2ee52f30 + meta: + chartId: 124 + height: 38 + sliceName: Growth Rate + uuid: 6cf742ee-281a-4673-a37c-587d6f29726a + width: 6 + type: CHART + CHART-37982887: + children: [] + id: CHART-37982887 + meta: + chartId: 122 + height: 52 + sliceName: World's Population + uuid: 78422cf9-f149-4491-b552-2ab0e3afffcf + width: 2 + type: CHART + CHART-97f4cb48: + children: [] + id: CHART-97f4cb48 + meta: + chartId: 127 + height: 38 + sliceName: Rural Breakdown + uuid: cdac97d6-28a2-4cff-a1d0-c8b81dcf29a6 + width: 3 + type: CHART + CHART-a4808bba: + children: [] + id: CHART-a4808bba + meta: + chartId: 130 + height: 50 + sliceName: Treemap + uuid: 71a12856-38a5-4978-be65-d0f4fde98aae + width: 8 + type: CHART + CHART-b5e05d6f: + children: [] + id: CHART-b5e05d6f + meta: + chartId: 128 + height: 50 + sliceName: World's Pop Growth + uuid: 6f7e8cc4-c850-4992-85a4-b161a782abc6 + width: 4 + type: CHART + CHART-e76e9f5f: + children: [] + id: CHART-e76e9f5f + meta: + chartId: 129 + height: 50 + sliceName: Box plot + uuid: 53c450c6-98bf-435a-8ebb-2a237bccfd09 + width: 4 + type: CHART + COLUMN-071bbbad: + children: + - ROW-1e064e3c + - ROW-afdefba9 + id: COLUMN-071bbbad + meta: + background: BACKGROUND_TRANSPARENT + width: 9 + type: COLUMN + COLUMN-fe3914b8: + children: + - CHART-37982887 + id: COLUMN-fe3914b8 + meta: + background: BACKGROUND_TRANSPARENT + width: 2 + type: COLUMN + DASHBOARD_VERSION_KEY: v2 + GRID_ID: + children: + - ROW-46632bc2 + - ROW-3fa26c5d + - ROW-812b3f13 + id: GRID_ID + type: GRID + HEADER_ID: + id: HEADER_ID + meta: + text: World's Bank Data + type: HEADER + ROOT_ID: + children: + - GRID_ID + id: ROOT_ID + type: ROOT + ROW-1e064e3c: + children: + - COLUMN-fe3914b8 + - CHART-2d5b6871 + id: ROW-1e064e3c + meta: + background: BACKGROUND_TRANSPARENT + type: ROW + ROW-3fa26c5d: + children: + - CHART-b5e05d6f + - CHART-0fd0d252 + id: ROW-3fa26c5d + meta: + background: BACKGROUND_TRANSPARENT + type: ROW + ROW-46632bc2: + children: + - COLUMN-071bbbad + - CHART-17e0f8d8 + id: ROW-46632bc2 + meta: + background: BACKGROUND_TRANSPARENT + type: ROW + ROW-812b3f13: + children: + - CHART-a4808bba + - CHART-e76e9f5f + id: ROW-812b3f13 + meta: + background: BACKGROUND_TRANSPARENT + type: ROW + ROW-afdefba9: + children: + - CHART-2ee52f30 + - CHART-97f4cb48 + id: ROW-afdefba9 + meta: + background: BACKGROUND_TRANSPARENT + type: ROW +published: true +slug: world_health +uuid: be064106-05ab-4501-9695-c2f11547bddc +version: 1.0.0 diff --git a/superset/examples/world_health/data.parquet b/superset/examples/world_health/data.parquet new file mode 100644 index 00000000000..3b49720bac0 Binary files /dev/null and b/superset/examples/world_health/data.parquet differ diff --git a/superset/examples/world_health/dataset.yaml b/superset/examples/world_health/dataset.yaml new file mode 100644 index 00000000000..f39fed99310 --- /dev/null +++ b/superset/examples/world_health/dataset.yaml @@ -0,0 +1,4319 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +always_filter_main_dttm: false +cache_timeout: null +catalog: null +columns: +- advanced_data_type: null + column_name: country_name + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: country_code + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: region + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: VARCHAR + verbose_name: null +- advanced_data_type: null + column_name: year + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: true + python_date_format: null + type: TIMESTAMP WITHOUT TIME ZONE + verbose_name: null +- advanced_data_type: null + column_name: NY_GNP_PCAP_CD + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_ADT_1524_LT_FM_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_ADT_1524_LT_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_ADT_1524_LT_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_ADT_LITR_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_ADT_LITR_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_ADT_LITR_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_ENR_ORPH + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_PRM_CMPT_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_PRM_CMPT_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_PRM_CMPT_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_PRM_ENRR + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_PRM_ENRR_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_PRM_ENRR_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_PRM_NENR + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_PRM_NENR_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_PRM_NENR_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_SEC_ENRR + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_SEC_ENRR_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_SEC_ENRR_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_SEC_NENR + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_SEC_NENR_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_SEC_NENR_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_TER_ENRR + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_TER_ENRR_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SE_XPD_TOTL_GD_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_ANM_CHLD_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_ANM_NPRG_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_CON_1524_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_CON_1524_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_CON_AIDS_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_CON_AIDS_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_DTH_COMM_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_DTH_IMRT + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_DTH_INJR_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_DTH_MORT + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_DTH_NCOM_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_DTH_NMRT + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_DYN_AIDS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_DYN_AIDS_DH + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_DYN_AIDS_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_DYN_AIDS_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_DYN_MORT + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_DYN_MORT_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_DYN_MORT_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_DYN_NMRT + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_FPL_SATI_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_H2O_SAFE_RU_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_H2O_SAFE_UR_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_H2O_SAFE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_HIV_0014 + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_HIV_1524_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_HIV_1524_KW_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_HIV_1524_KW_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_HIV_1524_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_HIV_ARTC_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_HIV_KNOW_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_HIV_KNOW_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_HIV_ORPH + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_HIV_TOTL + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_IMM_HEPB + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_IMM_HIB3 + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_IMM_IBCG + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_IMM_IDPT + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_IMM_MEAS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_IMM_POL3 + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_MED_BEDS_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_MED_CMHW_P3 + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_MED_NUMW_P3 + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_MED_PHYS_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_MLR_NETS_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_MLR_PREG_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_MLR_SPF2_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_MLR_TRET_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_MMR_DTHS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_MMR_LEVE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_MMR_RISK + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_MMR_RISK_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_MMR_WAGE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_PRG_ANEM + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_PRG_ARTC_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_PRG_SYPH_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_PRV_SMOK_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_PRV_SMOK_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_ACSN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_ACSN_RU + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_ACSN_UR + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_ANV4_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_ANVC_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_ARIC_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_BFED_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_BRTC_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_BRTW_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_DIAB_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_IYCF_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_MALN_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_MALN_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_MALN_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_MALR + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_MMRT + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_MMRT_NE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_ORCF_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_ORTH + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_OW15_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_OW15_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_OW15_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_OWGH_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_OWGH_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_OWGH_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_PNVC_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_STNT_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_STNT_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_STNT_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_WAST_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_WAST_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_STA_WAST_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_SVR_WAST_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_SVR_WAST_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_SVR_WAST_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_TBS_CURE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_TBS_DTEC_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_TBS_INCD + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_TBS_MORT + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_TBS_PREV + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_VAC_TTNS_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_XPD_EXTR_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_XPD_OOPC_TO_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_XPD_OOPC_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_XPD_PCAP + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_XPD_PCAP_PP_KD + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_XPD_PRIV + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_XPD_PRIV_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_XPD_PUBL + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_XPD_PUBL_GX_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_XPD_PUBL_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_XPD_TOTL_CD + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SH_XPD_TOTL_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SI_POV_NAHC + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SI_POV_RUHC + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SI_POV_URHC + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SL_EMP_INSV_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SL_TLF_TOTL_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SL_TLF_TOTL_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SL_UEM_TOTL_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SL_UEM_TOTL_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SL_UEM_TOTL_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SM_POP_NETM + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SN_ITK_DEFC + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SN_ITK_DEFC_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SN_ITK_SALT_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SN_ITK_VITA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_ADO_TFRT + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_AMRT_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_AMRT_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_CBRT_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_CDRT_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_CONU_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_IMRT_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_IMRT_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_IMRT_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_LE00_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_LE00_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_LE00_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_SMAM_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_SMAM_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_TFRT_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_TO65_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_TO65_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_DYN_WFRT + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_HOU_FEMA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_MTR_1519_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_0004_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_0004_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_0004_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_0004_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_0014_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_0014_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_0014_TO + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_0014_TO_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_0509_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_0509_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_0509_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_0509_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_1014_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_1014_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_1014_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_1014_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_1519_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_1519_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_1519_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_1519_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_1564_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_1564_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_1564_TO + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_1564_TO_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_2024_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_2024_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_2024_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_2024_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_2529_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_2529_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_2529_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_2529_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_3034_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_3034_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_3034_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_3034_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_3539_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_3539_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_3539_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_3539_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_4044_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_4044_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_4044_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_4044_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_4549_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_4549_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_4549_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_4549_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_5054_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_5054_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_5054_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_5054_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_5559_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_5559_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_5559_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_5559_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_6064_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_6064_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_6064_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_6064_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_6569_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_6569_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_6569_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_6569_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_65UP_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_65UP_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_65UP_TO + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_65UP_TO_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_7074_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_7074_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_7074_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_7074_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_7579_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_7579_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_7579_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_7579_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_80UP_FE + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_80UP_FE_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_80UP_MA + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_80UP_MA_5Y + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG00_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG00_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG01_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG01_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG02_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG02_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG03_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG03_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG04_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG04_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG05_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG05_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG06_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG06_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG07_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG07_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG08_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG08_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG09_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG09_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG10_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG10_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG11_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG11_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG12_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG12_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG13_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG13_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG14_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG14_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG15_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG15_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG16_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG16_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG17_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG17_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG18_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG18_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG19_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG19_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG20_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG20_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG21_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG21_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG22_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG22_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG23_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG23_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG24_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG24_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG25_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_AG25_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_BRTH_MF + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_DPND + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_DPND_OL + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_DPND_YG + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_GROW + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_TOTL + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_TOTL_FE_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_TOTL_FE_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_TOTL_MA_IN + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_POP_TOTL_MA_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_REG_BRTH_RU_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_REG_BRTH_UR_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_REG_BRTH_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_REG_DTHS_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_RUR_TOTL + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_RUR_TOTL_ZG + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_RUR_TOTL_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_URB_GROW + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_URB_TOTL + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_URB_TOTL_IN_ZS + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +- advanced_data_type: null + column_name: SP_UWT_TFRT + description: null + expression: '' + extra: null + filterable: true + groupby: true + is_active: true + is_dttm: false + python_date_format: null + type: FLOAT + verbose_name: null +data_file: data.parquet +database_uuid: a2dc77af-e654-49bb-b321-40f6b559a1ee +default_endpoint: null +description: "\nThis data was\ + \ downloaded from the\n[World's Health Organization's website](https://datacatalog.worldbank.org/dataset/health-nutrition-and-population-statistics)\n\ + \nHere's the script that was used to massage the data:\n\n DIR = \"\"\n df_country\ + \ = pd.read_csv(DIR + '/HNP_Country.csv')\n df_country.columns = ['country_code']\ + \ + list(df_country.columns[1:])\n df_country = df_country[['country_code', 'Region']]\n\ + \ df_country.columns = ['country_code', 'region']\n\n df = pd.read_csv(DIR\ + \ + '/HNP_Data.csv')\n del df['Unnamed: 60']\n df.columns = ['country_name',\ + \ 'country_code'] + list(df.columns[2:])\n ndf = df.merge(df_country, how='inner')\n\ + \n dims = ('country_name', 'country_code', 'region')\n vv = [str(i) for i\ + \ in range(1960, 2015)]\n mdf = pd.melt(ndf, id_vars=dims + ('Indicator Code',),\ + \ value_vars=vv)\n mdf['year'] = mdf.variable + '-01-01'\n dims = dims + ('year',)\n\ + \n pdf = mdf.pivot_table(values='value', columns='Indicator Code', index=dims)\n\ + \ pdf = pdf.reset_index()\n pdf.to_csv(DIR + '/countries.csv')\n pdf.to_json(DIR\ + \ + '/countries.json', orient='records')\n\nHere's the description of the metrics\ + \ available:\n\nSeries | Code Indicator Name\n--- | ---\nNY.GNP.PCAP.CD | GNI per\ + \ capita, Atlas method (current US$)\nSE.ADT.1524.LT.FM.ZS | Literacy rate, youth\ + \ (ages 15-24), gender parity index (GPI)\nSE.ADT.1524.LT.MA.ZS | Literacy rate,\ + \ youth male (% of males ages 15-24)\nSE.ADT.1524.LT.ZS | Literacy rate, youth total\ + \ (% of people ages 15-24)\nSE.ADT.LITR.FE.ZS | Literacy rate, adult female (% of\ + \ females ages 15 and above)\nSE.ADT.LITR.MA.ZS | Literacy rate, adult male (% of\ + \ males ages 15 and above)\nSE.ADT.LITR.ZS | Literacy rate, adult total (% of people\ + \ ages 15 and above)\nSE.ENR.ORPH | Ratio of school attendance of orphans to school\ + \ attendance of non-orphans ages 10-14\nSE.PRM.CMPT.FE.ZS | Primary completion rate,\ + \ female (% of relevant age group)\nSE.PRM.CMPT.MA.ZS | Primary completion rate,\ + \ male (% of relevant age group)\nSE.PRM.CMPT.ZS | Primary completion rate, total\ + \ (% of relevant age group)\nSE.PRM.ENRR | School enrollment, primary (% gross)\n\ + SE.PRM.ENRR.FE | School enrollment, primary, female (% gross)\nSE.PRM.ENRR.MA |\ + \ School enrollment, primary, male (% gross)\nSE.PRM.NENR | School enrollment, primary\ + \ (% net)\nSE.PRM.NENR.FE | School enrollment, primary, female (% net)\nSE.PRM.NENR.MA\ + \ | School enrollment, primary, male (% net)\nSE.SEC.ENRR | School enrollment, secondary\ + \ (% gross)\nSE.SEC.ENRR.FE | School enrollment, secondary, female (% gross)\nSE.SEC.ENRR.MA\ + \ | School enrollment, secondary, male (% gross)\nSE.SEC.NENR | School enrollment,\ + \ secondary (% net)\nSE.SEC.NENR.FE | School enrollment, secondary, female (% net)\n\ + SE.SEC.NENR.MA | School enrollment, secondary, male (% net)\nSE.TER.ENRR | School\ + \ enrollment, tertiary (% gross)\nSE.TER.ENRR.FE | School enrollment, tertiary,\ + \ female (% gross)\nSE.XPD.TOTL.GD.ZS | Government expenditure on education, total\ + \ (% of GDP)\nSH.ANM.CHLD.ZS | Prevalence of anemia among children (% of children\ + \ under 5)\nSH.ANM.NPRG.ZS | Prevalence of anemia among non-pregnant women (% of\ + \ women ages 15-49)\nSH.CON.1524.FE.ZS | Condom use, population ages 15-24, female\ + \ (% of females ages 15-24)\nSH.CON.1524.MA.ZS | Condom use, population ages 15-24,\ + \ male (% of males ages 15-24)\nSH.CON.AIDS.FE.ZS | Condom use at last high-risk\ + \ sex, adult female (% ages 15-49)\nSH.CON.AIDS.MA.ZS | Condom use at last high-risk\ + \ sex, adult male (% ages 15-49)\nSH.DTH.COMM.ZS | Cause of death, by communicable\ + \ diseases and maternal, prenatal and nutrition conditions (% of total)\nSH.DTH.IMRT\ + \ | Number of infant deaths\nSH.DTH.INJR.ZS | Cause of death, by injury (% of total)\n\ + SH.DTH.MORT | Number of under-five deaths\nSH.DTH.NCOM.ZS | Cause of death, by non-communicable\ + \ diseases (% of total)\nSH.DTH.NMRT | Number of neonatal deaths\nSH.DYN.AIDS |\ + \ Adults (ages 15+) living with HIV\nSH.DYN.AIDS.DH | AIDS estimated deaths (UNAIDS\ + \ estimates)\nSH.DYN.AIDS.FE.ZS | Women's share of population ages 15+ living with\ + \ HIV (%)\nSH.DYN.AIDS.ZS | Prevalence of HIV, total (% of population ages 15-49)\n\ + SH.DYN.MORT | Mortality rate, under-5 (per 1,000 live births)\nSH.DYN.MORT.FE |\ + \ Mortality rate, under-5, female (per 1,000 live births)\nSH.DYN.MORT.MA | Mortality\ + \ rate, under-5, male (per 1,000 live births)\nSH.DYN.NMRT | Mortality rate, neonatal\ + \ (per 1,000 live births)\nSH.FPL.SATI.ZS | Met need for contraception (% of married\ + \ women ages 15-49)\nSH.H2O.SAFE.RU.ZS | Improved water source, rural (% of rural\ + \ population with access)\nSH.H2O.SAFE.UR.ZS | Improved water source, urban (% of\ + \ urban population with access)\nSH.H2O.SAFE.ZS | Improved water source (% of population\ + \ with access)\nSH.HIV.0014 | Children (0-14) living with HIV\nSH.HIV.1524.FE.ZS\ + \ | Prevalence of HIV, female (% ages 15-24)\nSH.HIV.1524.KW.FE.ZS | Comprehensive\ + \ correct knowledge of HIV/AIDS, ages 15-24, female (2 prevent ways and reject 3\ + \ misconceptions)\nSH.HIV.1524.KW.MA.ZS | Comprehensive correct knowledge of HIV/AIDS,\ + \ ages 15-24, male (2 prevent ways and reject 3 misconceptions)\nSH.HIV.1524.MA.ZS\ + \ | Prevalence of HIV, male (% ages 15-24)\nSH.HIV.ARTC.ZS | Antiretroviral therapy\ + \ coverage (% of people living with HIV)\nSH.HIV.KNOW.FE.ZS | % of females ages\ + \ 15-49 having comprehensive correct knowledge about HIV (2 prevent ways and reject\ + \ 3 misconceptions)\nSH.HIV.KNOW.MA.ZS | % of males ages 15-49 having comprehensive\ + \ correct knowledge about HIV (2 prevent ways and reject 3 misconceptions)\nSH.HIV.ORPH\ + \ | Children orphaned by HIV/AIDS\nSH.HIV.TOTL | Adults (ages 15+) and children\ + \ (0-14 years) living with HIV\nSH.IMM.HEPB | Immunization, HepB3 (% of one-year-old\ + \ children)\nSH.IMM.HIB3 | Immunization, Hib3 (% of children ages 12-23 months)\n\ + SH.IMM.IBCG | Immunization, BCG (% of one-year-old children)\nSH.IMM.IDPT | Immunization,\ + \ DPT (% of children ages 12-23 months)\nSH.IMM.MEAS | Immunization, measles (%\ + \ of children ages 12-23 months)\nSH.IMM.POL3 | Immunization, Pol3 (% of one-year-old\ + \ children)\nSH.MED.BEDS.ZS | Hospital beds (per 1,000 people)\nSH.MED.CMHW.P3 |\ + \ Community health workers (per 1,000 people)\nSH.MED.NUMW.P3 | Nurses and midwives\ + \ (per 1,000 people)\nSH.MED.PHYS.ZS | Physicians (per 1,000 people)\nSH.MLR.NETS.ZS\ + \ | Use of insecticide-treated bed nets (% of under-5 population)\nSH.MLR.PREG.ZS\ + \ | Use of any antimalarial drug (% of pregnant women)\nSH.MLR.SPF2.ZS | Use of\ + \ Intermittent Preventive Treatment of malaria, 2+ doses of SP/Fansidar (% of pregnant\ + \ women)\nSH.MLR.TRET.ZS | Children with fever receiving antimalarial drugs (% of\ + \ children under age 5 with fever)\nSH.MMR.DTHS | Number of maternal deaths\nSH.MMR.LEVE\ + \ | Number of weeks of maternity leave\nSH.MMR.RISK | Lifetime risk of maternal\ + \ death (1 in: rate varies by country)\nSH.MMR.RISK.ZS | Lifetime risk of maternal\ + \ death (%)\nSH.MMR.WAGE.ZS | Maternal leave benefits (% of wages paid in covered\ + \ period)\nSH.PRG.ANEM | Prevalence of anemia among pregnant women (%)\nSH.PRG.ARTC.ZS\ + \ | Antiretroviral therapy coverage (% of pregnant women living with HIV)\nSH.PRG.SYPH.ZS\ + \ | Prevalence of syphilis (% of women attending antenatal care)\nSH.PRV.SMOK.FE\ + \ | Smoking prevalence, females (% of adults)\nSH.PRV.SMOK.MA | Smoking prevalence,\ + \ males (% of adults)\nSH.STA.ACSN | Improved sanitation facilities (% of population\ + \ with access)\nSH.STA.ACSN.RU | Improved sanitation facilities, rural (% of rural\ + \ population with access)\nSH.STA.ACSN.UR | Improved sanitation facilities, urban\ + \ (% of urban population with access)\nSH.STA.ANV4.ZS | Pregnant women receiving\ + \ prenatal care of at least four visits (% of pregnant women)\nSH.STA.ANVC.ZS |\ + \ Pregnant women receiving prenatal care (%)\nSH.STA.ARIC.ZS | ARI treatment (%\ + \ of children under 5 taken to a health provider)\nSH.STA.BFED.ZS | Exclusive breastfeeding\ + \ (% of children under 6 months)\nSH.STA.BRTC.ZS | Births attended by skilled health\ + \ staff (% of total)\nSH.STA.BRTW.ZS | Low-birthweight babies (% of births)\nSH.STA.DIAB.ZS\ + \ | Diabetes prevalence (% of population ages 20 to 79)\nSH.STA.IYCF.ZS | Infant\ + \ and young child feeding practices, all 3 IYCF (% children ages 6-23 months)\n\ + SH.STA.MALN.FE.ZS | Prevalence of underweight, weight for age, female (% of children\ + \ under 5)\nSH.STA.MALN.MA.ZS | Prevalence of underweight, weight for age, male\ + \ (% of children under 5)\nSH.STA.MALN.ZS | Prevalence of underweight, weight for\ + \ age (% of children under 5)\nSH.STA.MALR | Malaria cases reported\nSH.STA.MMRT\ + \ | Maternal mortality ratio (modeled estimate, per 100,000 live births)\nSH.STA.MMRT.NE\ + \ | Maternal mortality ratio (national estimate, per 100,000 live births)\nSH.STA.ORCF.ZS\ + \ | Diarrhea treatment (% of children under 5 receiving oral rehydration and continued\ + \ feeding)\nSH.STA.ORTH | Diarrhea treatment (% of children under 5 who received\ + \ ORS packet)\nSH.STA.OW15.FE.ZS | Prevalence of overweight, female (% of female\ + \ adults)\nSH.STA.OW15.MA.ZS | Prevalence of overweight, male (% of male adults)\n\ + SH.STA.OW15.ZS | Prevalence of overweight (% of adults)\nSH.STA.OWGH.FE.ZS | Prevalence\ + \ of overweight, weight for height, female (% of children under 5)\nSH.STA.OWGH.MA.ZS\ + \ | Prevalence of overweight, weight for height, male (% of children under 5)\n\ + SH.STA.OWGH.ZS | Prevalence of overweight, weight for height (% of children under\ + \ 5)\nSH.STA.PNVC.ZS | Postnatal care coverage (% mothers)\nSH.STA.STNT.FE.ZS |\ + \ Prevalence of stunting, height for age, female (% of children under 5)\nSH.STA.STNT.MA.ZS\ + \ | Prevalence of stunting, height for age, male (% of children under 5)\nSH.STA.STNT.ZS\ + \ | Prevalence of stunting, height for age (% of children under 5)\nSH.STA.WAST.FE.ZS\ + \ | Prevalence of wasting, weight for height, female (% of children under 5)\nSH.STA.WAST.MA.ZS\ + \ | Prevalence of wasting, weight for height, male (% of children under 5)\nSH.STA.WAST.ZS\ + \ | Prevalence of wasting, weight for height (% of children under 5)\nSH.SVR.WAST.FE.ZS\ + \ | Prevalence of severe wasting, weight for height, female (% of children under\ + \ 5)\nSH.SVR.WAST.MA.ZS | Prevalence of severe wasting, weight for height, male\ + \ (% of children under 5)\nSH.SVR.WAST.ZS | Prevalence of severe wasting, weight\ + \ for height (% of children under 5)\nSH.TBS.CURE.ZS | Tuberculosis treatment success\ + \ rate (% of new cases)\nSH.TBS.DTEC.ZS | Tuberculosis case detection rate (%, all\ + \ forms)\nSH.TBS.INCD | Incidence of tuberculosis (per 100,000 people)\nSH.TBS.MORT\ + \ | Tuberculosis death rate (per 100,000 people)\nSH.TBS.PREV | Prevalence of tuberculosis\ + \ (per 100,000 population)\nSH.VAC.TTNS.ZS | Newborns protected against tetanus\ + \ (%)\nSH.XPD.EXTR.ZS | External resources for health (% of total expenditure on\ + \ health)\nSH.XPD.OOPC.TO.ZS | Out-of-pocket health expenditure (% of total expenditure\ + \ on health)\nSH.XPD.OOPC.ZS | Out-of-pocket health expenditure (% of private expenditure\ + \ on health)\nSH.XPD.PCAP | Health expenditure per capita (current US$)\nSH.XPD.PCAP.PP.KD\ + \ | Health expenditure per capita, PPP (constant 2011 international $)\nSH.XPD.PRIV\ + \ | Health expenditure, private (% of total health expenditure)\nSH.XPD.PRIV.ZS\ + \ | Health expenditure, private (% of GDP)\nSH.XPD.PUBL | Health expenditure, public\ + \ (% of total health expenditure)\nSH.XPD.PUBL.GX.ZS | Health expenditure, public\ + \ (% of government expenditure)\nSH.XPD.PUBL.ZS | Health expenditure, public (%\ + \ of GDP)\nSH.XPD.TOTL.CD | Health expenditure, total (current US$)\nSH.XPD.TOTL.ZS\ + \ | Health expenditure, total (% of GDP)\nSI.POV.NAHC | Poverty headcount ratio\ + \ at national poverty lines (% of population)\nSI.POV.RUHC | Rural poverty headcount\ + \ ratio at national poverty lines (% of rural population)\nSI.POV.URHC | Urban poverty\ + \ headcount ratio at national poverty lines (% of urban population)\nSL.EMP.INSV.FE.ZS\ + \ | Share of women in wage employment in the nonagricultural sector (% of total\ + \ nonagricultural employment)\nSL.TLF.TOTL.FE.ZS | Labor force, female (% of total\ + \ labor force)\nSL.TLF.TOTL.IN | Labor force, total\nSL.UEM.TOTL.FE.ZS | Unemployment,\ + \ female (% of female labor force) (modeled ILO estimate)\nSL.UEM.TOTL.MA.ZS | Unemployment,\ + \ male (% of male labor force) (modeled ILO estimate)\nSL.UEM.TOTL.ZS | Unemployment,\ + \ total (% of total labor force) (modeled ILO estimate)\nSM.POP.NETM | Net migration\n\ + SN.ITK.DEFC | Number of people who are undernourished\nSN.ITK.DEFC.ZS | Prevalence\ + \ of undernourishment (% of population)\nSN.ITK.SALT.ZS | Consumption of iodized\ + \ salt (% of households)\nSN.ITK.VITA.ZS | Vitamin A supplementation coverage rate\ + \ (% of children ages 6-59 months)\nSP.ADO.TFRT | Adolescent fertility rate (births\ + \ per 1,000 women ages 15-19)\nSP.DYN.AMRT.FE | Mortality rate, adult, female (per\ + \ 1,000 female adults)\nSP.DYN.AMRT.MA | Mortality rate, adult, male (per 1,000\ + \ male adults)\nSP.DYN.CBRT.IN | Birth rate, crude (per 1,000 people)\nSP.DYN.CDRT.IN\ + \ | Death rate, crude (per 1,000 people)\nSP.DYN.CONU.ZS | Contraceptive prevalence\ + \ (% of women ages 15-49)\nSP.DYN.IMRT.FE.IN | Mortality rate, infant, female (per\ + \ 1,000 live births)\nSP.DYN.IMRT.IN | Mortality rate, infant (per 1,000 live births)\n\ + SP.DYN.IMRT.MA.IN | Mortality rate, infant, male (per 1,000 live births)\nSP.DYN.LE00.FE.IN\ + \ | Life expectancy at birth, female (years)\nSP.DYN.LE00.IN | Life expectancy at\ + \ birth, total (years)\nSP.DYN.LE00.MA.IN | Life expectancy at birth, male (years)\n\ + SP.DYN.SMAM.FE | Mean age at first marriage, female\nSP.DYN.SMAM.MA | Mean age at\ + \ first marriage, male\nSP.DYN.TFRT.IN | Fertility rate, total (births per woman)\n\ + SP.DYN.TO65.FE.ZS | Survival to age 65, female (% of cohort)\nSP.DYN.TO65.MA.ZS\ + \ | Survival to age 65, male (% of cohort)\nSP.DYN.WFRT | Wanted fertility rate\ + \ (births per woman)\nSP.HOU.FEMA.ZS | Female headed households (% of households\ + \ with a female head)\nSP.MTR.1519.ZS | Teenage mothers (% of women ages 15-19 who\ + \ have had children or are currently pregnant)\nSP.POP.0004.FE | Population ages\ + \ 0-4, female\nSP.POP.0004.FE.5Y | Population ages 0-4, female (% of female population)\n\ + SP.POP.0004.MA | Population ages 0-4, male\nSP.POP.0004.MA.5Y | Population ages\ + \ 0-4, male (% of male population)\nSP.POP.0014.FE.ZS | Population ages 0-14, female\ + \ (% of total)\nSP.POP.0014.MA.ZS | Population ages 0-14, male (% of total)\nSP.POP.0014.TO\ + \ | Population ages 0-14, total\nSP.POP.0014.TO.ZS | Population ages 0-14 (% of\ + \ total)\nSP.POP.0509.FE | Population ages 5-9, female\nSP.POP.0509.FE.5Y | Population\ + \ ages 5-9, female (% of female population)\nSP.POP.0509.MA | Population ages 5-9,\ + \ male\nSP.POP.0509.MA.5Y | Population ages 5-9, male (% of male population)\nSP.POP.1014.FE\ + \ | Population ages 10-14, female\nSP.POP.1014.FE.5Y | Population ages 10-14, female\ + \ (% of female population)\nSP.POP.1014.MA | Population ages 10-14, male\nSP.POP.1014.MA.5Y\ + \ | Population ages 10-14, male (% of male population)\nSP.POP.1519.FE | Population\ + \ ages 15-19, female\nSP.POP.1519.FE.5Y | Population ages 15-19, female (% of female\ + \ population)\nSP.POP.1519.MA | Population ages 15-19, male\nSP.POP.1519.MA.5Y |\ + \ Population ages 15-19, male (% of male population)\nSP.POP.1564.FE.ZS | Population\ + \ ages 15-64, female (% of total)\nSP.POP.1564.MA.ZS | Population ages 15-64, male\ + \ (% of total)\nSP.POP.1564.TO | Population ages 15-64, total\nSP.POP.1564.TO.ZS\ + \ | Population ages 15-64 (% of total)\nSP.POP.2024.FE | Population ages 20-24,\ + \ female\nSP.POP.2024.FE.5Y | Population ages 20-24, female (% of female population)\n\ + SP.POP.2024.MA | Population ages 20-24, male\nSP.POP.2024.MA.5Y | Population ages\ + \ 20-24, male (% of male population)\nSP.POP.2529.FE | Population ages 25-29, female\n\ + SP.POP.2529.FE.5Y | Population ages 25-29, female (% of female population)\nSP.POP.2529.MA\ + \ | Population ages 25-29, male\nSP.POP.2529.MA.5Y | Population ages 25-29, male\ + \ (% of male population)\nSP.POP.3034.FE | Population ages 30-34, female\nSP.POP.3034.FE.5Y\ + \ | Population ages 30-34, female (% of female population)\nSP.POP.3034.MA | Population\ + \ ages 30-34, male\nSP.POP.3034.MA.5Y | Population ages 30-34, male (% of male population)\n\ + SP.POP.3539.FE | Population ages 35-39, female\nSP.POP.3539.FE.5Y | Population ages\ + \ 35-39, female (% of female population)\nSP.POP.3539.MA | Population ages 35-39,\ + \ male\nSP.POP.3539.MA.5Y | Population ages 35-39, male (% of male population)\n\ + SP.POP.4044.FE | Population ages 40-44, female\nSP.POP.4044.FE.5Y | Population ages\ + \ 40-44, female (% of female population)\nSP.POP.4044.MA | Population ages 40-44,\ + \ male\nSP.POP.4044.MA.5Y | Population ages 40-44, male (% of male population)\n\ + SP.POP.4549.FE | Population ages 45-49, female\nSP.POP.4549.FE.5Y | Population ages\ + \ 45-49, female (% of female population)\nSP.POP.4549.MA | Population ages 45-49,\ + \ male\nSP.POP.4549.MA.5Y | Population ages 45-49, male (% of male population)\n\ + SP.POP.5054.FE | Population ages 50-54, female\nSP.POP.5054.FE.5Y | Population ages\ + \ 50-54, female (% of female population)\nSP.POP.5054.MA | Population ages 50-54,\ + \ male\nSP.POP.5054.MA.5Y | Population ages 50-54, male (% of male population)\n\ + SP.POP.5559.FE | Population ages 55-59, female\nSP.POP.5559.FE.5Y | Population ages\ + \ 55-59, female (% of female population)\nSP.POP.5559.MA | Population ages 55-59,\ + \ male\nSP.POP.5559.MA.5Y | Population ages 55-59, male (% of male population)\n\ + SP.POP.6064.FE | Population ages 60-64, female\nSP.POP.6064.FE.5Y | Population ages\ + \ 60-64, female (% of female population)\nSP.POP.6064.MA | Population ages 60-64,\ + \ male\nSP.POP.6064.MA.5Y | Population ages 60-64, male (% of male population)\n\ + SP.POP.6569.FE | Population ages 65-69, female\nSP.POP.6569.FE.5Y | Population ages\ + \ 65-69, female (% of female population)\nSP.POP.6569.MA | Population ages 65-69,\ + \ male\nSP.POP.6569.MA.5Y | Population ages 65-69, male (% of male population)\n\ + SP.POP.65UP.FE.ZS | Population ages 65 and above, female (% of total)\nSP.POP.65UP.MA.ZS\ + \ | Population ages 65 and above, male (% of total)\nSP.POP.65UP.TO | Population\ + \ ages 65 and above, total\nSP.POP.65UP.TO.ZS | Population ages 65 and above (%\ + \ of total)\nSP.POP.7074.FE | Population ages 70-74, female\nSP.POP.7074.FE.5Y |\ + \ Population ages 70-74, female (% of female population)\nSP.POP.7074.MA | Population\ + \ ages 70-74, male\nSP.POP.7074.MA.5Y | Population ages 70-74, male (% of male population)\n\ + SP.POP.7579.FE | Population ages 75-79, female\nSP.POP.7579.FE.5Y | Population ages\ + \ 75-79, female (% of female population)\nSP.POP.7579.MA | Population ages 75-79,\ + \ male\nSP.POP.7579.MA.5Y | Population ages 75-79, male (% of male population)\n\ + SP.POP.80UP.FE | Population ages 80 and above, female\nSP.POP.80UP.FE.5Y | Population\ + \ ages 80 and above, female (% of female population)\nSP.POP.80UP.MA | Population\ + \ ages 80 and above, male\nSP.POP.80UP.MA.5Y | Population ages 80 and above, male\ + \ (% of male population)\nSP.POP.AG00.FE.IN | Age population, age 0, female, interpolated\n\ + SP.POP.AG00.MA.IN | Age population, age 0, male, interpolated\nSP.POP.AG01.FE.IN\ + \ | Age population, age 01, female, interpolated\nSP.POP.AG01.MA.IN | Age population,\ + \ age 01, male, interpolated\nSP.POP.AG02.FE.IN | Age population, age 02, female,\ + \ interpolated\nSP.POP.AG02.MA.IN | Age population, age 02, male, interpolated\n\ + SP.POP.AG03.FE.IN | Age population, age 03, female, interpolated\nSP.POP.AG03.MA.IN\ + \ | Age population, age 03, male, interpolated\nSP.POP.AG04.FE.IN | Age population,\ + \ age 04, female, interpolated\nSP.POP.AG04.MA.IN | Age population, age 04, male,\ + \ interpolated\nSP.POP.AG05.FE.IN | Age population, age 05, female, interpolated\n\ + SP.POP.AG05.MA.IN | Age population, age 05, male, interpolated\nSP.POP.AG06.FE.IN\ + \ | Age population, age 06, female, interpolated\nSP.POP.AG06.MA.IN | Age population,\ + \ age 06, male, interpolated\nSP.POP.AG07.FE.IN | Age population, age 07, female,\ + \ interpolated\nSP.POP.AG07.MA.IN | Age population, age 07, male, interpolated\n\ + SP.POP.AG08.FE.IN | Age population, age 08, female, interpolated\nSP.POP.AG08.MA.IN\ + \ | Age population, age 08, male, interpolated\nSP.POP.AG09.FE.IN | Age population,\ + \ age 09, female, interpolated\nSP.POP.AG09.MA.IN | Age population, age 09, male,\ + \ interpolated\nSP.POP.AG10.FE.IN | Age population, age 10, female, interpolated\n\ + SP.POP.AG10.MA.IN | Age population, age 10, male\nSP.POP.AG11.FE.IN | Age population,\ + \ age 11, female, interpolated\nSP.POP.AG11.MA.IN | Age population, age 11, male\n\ + SP.POP.AG12.FE.IN | Age population, age 12, female, interpolated\nSP.POP.AG12.MA.IN\ + \ | Age population, age 12, male\nSP.POP.AG13.FE.IN | Age population, age 13, female,\ + \ interpolated\nSP.POP.AG13.MA.IN | Age population, age 13, male\nSP.POP.AG14.FE.IN\ + \ | Age population, age 14, female, interpolated\nSP.POP.AG14.MA.IN | Age population,\ + \ age 14, male\nSP.POP.AG15.FE.IN | Age population, age 15, female, interpolated\n\ + SP.POP.AG15.MA.IN | Age population, age 15, male, interpolated\nSP.POP.AG16.FE.IN\ + \ | Age population, age 16, female, interpolated\nSP.POP.AG16.MA.IN | Age population,\ + \ age 16, male, interpolated\nSP.POP.AG17.FE.IN | Age population, age 17, female,\ + \ interpolated\nSP.POP.AG17.MA.IN | Age population, age 17, male, interpolated\n\ + SP.POP.AG18.FE.IN | Age population, age 18, female, interpolated\nSP.POP.AG18.MA.IN\ + \ | Age population, age 18, male, interpolated\nSP.POP.AG19.FE.IN | Age population,\ + \ age 19, female, interpolated\nSP.POP.AG19.MA.IN | Age population, age 19, male,\ + \ interpolated\nSP.POP.AG20.FE.IN | Age population, age 20, female, interpolated\n\ + SP.POP.AG20.MA.IN | Age population, age 20, male, interpolated\nSP.POP.AG21.FE.IN\ + \ | Age population, age 21, female, interpolated\nSP.POP.AG21.MA.IN | Age population,\ + \ age 21, male, interpolated\nSP.POP.AG22.FE.IN | Age population, age 22, female,\ + \ interpolated\nSP.POP.AG22.MA.IN | Age population, age 22, male, interpolated\n\ + SP.POP.AG23.FE.IN | Age population, age 23, female, interpolated\nSP.POP.AG23.MA.IN\ + \ | Age population, age 23, male, interpolated\nSP.POP.AG24.FE.IN | Age population,\ + \ age 24, female, interpolated\nSP.POP.AG24.MA.IN | Age population, age 24, male,\ + \ interpolated\nSP.POP.AG25.FE.IN | Age population, age 25, female, interpolated\n\ + SP.POP.AG25.MA.IN | Age population, age 25, male, interpolated\nSP.POP.BRTH.MF |\ + \ Sex ratio at birth (male births per female births)\nSP.POP.DPND | Age dependency\ + \ ratio (% of working-age population)\nSP.POP.DPND.OL | Age dependency ratio, old\ + \ (% of working-age population)\nSP.POP.DPND.YG | Age dependency ratio, young (%\ + \ of working-age population)\nSP.POP.GROW | Population growth (annual %)\nSP.POP.TOTL\ + \ | Population, total\nSP.POP.TOTL.FE.IN | Population, female\nSP.POP.TOTL.FE.ZS\ + \ | Population, female (% of total)\nSP.POP.TOTL.MA.IN | Population, male\nSP.POP.TOTL.MA.ZS\ + \ | Population, male (% of total)\nSP.REG.BRTH.RU.ZS | Completeness of birth registration,\ + \ rural (%)\nSP.REG.BRTH.UR.ZS | Completeness of birth registration, urban (%)\n\ + SP.REG.BRTH.ZS | Completeness of birth registration (%)\nSP.REG.DTHS.ZS | Completeness\ + \ of death registration with cause-of-death information (%)\nSP.RUR.TOTL | Rural\ + \ population\nSP.RUR.TOTL.ZG | Rural population growth (annual %)\nSP.RUR.TOTL.ZS\ + \ | Rural population (% of total population)\nSP.URB.GROW | Urban population growth\ + \ (annual %)\nSP.URB.TOTL | Urban population\nSP.URB.TOTL.IN.ZS | Urban population\ + \ (% of total)\nSP.UWT.TFRT | Unmet need for contraception (% of married women ages\ + \ 15-49)\n" +extra: null +fetch_values_predicate: null +filter_select_enabled: true +folders: null +main_dttm_col: year +metrics: +- currency: null + d3format: null + description: null + expression: sum("SP_POP_TOTL") + extra: null + metric_name: sum__SP_POP_TOTL + metric_type: null + verbose_name: null + warning_text: null +- currency: null + d3format: null + description: null + expression: sum("SH_DYN_AIDS") + extra: null + metric_name: sum__SH_DYN_AIDS + metric_type: null + verbose_name: null + warning_text: null +- currency: null + d3format: null + description: null + expression: sum("SP_RUR_TOTL_ZS") + extra: null + metric_name: sum__SP_RUR_TOTL_ZS + metric_type: null + verbose_name: null + warning_text: null +- currency: null + d3format: null + description: null + expression: sum("SP_DYN_LE00_IN") + extra: null + metric_name: sum__SP_DYN_LE00_IN + metric_type: null + verbose_name: null + warning_text: null +- currency: null + d3format: null + description: null + expression: sum("SP_RUR_TOTL") + extra: null + metric_name: sum__SP_RUR_TOTL + metric_type: null + verbose_name: null + warning_text: null +- currency: null + d3format: null + description: null + expression: COUNT(*) + extra: null + metric_name: count + metric_type: count + verbose_name: COUNT(*) + warning_text: null +normalize_columns: false +offset: 0 +params: null +schema: null +sql: null +table_name: wb_health_population +template_params: null +uuid: 69e9de42-fe7f-4948-946a-f7913227aee8 +version: 1.0.0 diff --git a/superset/extensions/discovery.py b/superset/extensions/discovery.py index 5727a9d14b9..41ad69c18b3 100644 --- a/superset/extensions/discovery.py +++ b/superset/extensions/discovery.py @@ -23,6 +23,7 @@ from zipfile import is_zipfile, ZipFile from superset.extensions.types import LoadedExtension from superset.extensions.utils import get_bundle_files_from_zip, get_loaded_extension +from superset.utils import json logger = logging.getLogger(__name__) @@ -59,8 +60,27 @@ def discover_and_load_extensions( try: with ZipFile(supx_file, "r") as zip_file: + # Read the manifest first to get the extension ID for the + # supx:// path + try: + manifest_content = zip_file.read("manifest.json") + manifest_data = json.loads(manifest_content) + extension_id = manifest_data["id"] + except (KeyError, json.JSONDecodeError) as e: + logger.error( + "Failed to read extension ID from manifest in %s: %s", + supx_file, + e, + ) + continue + + # Use supx:// scheme for tracebacks + source_base_path = f"supx://{extension_id}" + files = get_bundle_files_from_zip(zip_file) - extension = get_loaded_extension(files) + extension = get_loaded_extension( + files, source_base_path=source_base_path + ) logger.info( "Loaded extension '%s' from %s", extension.id, supx_file ) diff --git a/superset/extensions/local_extensions_watcher.py b/superset/extensions/local_extensions_watcher.py index 6d79a3298af..4a5c9a0501b 100644 --- a/superset/extensions/local_extensions_watcher.py +++ b/superset/extensions/local_extensions_watcher.py @@ -32,6 +32,10 @@ if TYPE_CHECKING: logger = logging.getLogger(__name__) +# Guard to prevent multiple initializations +_watcher_initialized = False +_watcher_lock = threading.Lock() + def _get_file_handler_class() -> Any: """Get the file handler class, importing watchdog only when needed.""" @@ -68,6 +72,14 @@ def _get_file_handler_class() -> Any: def setup_local_extensions_watcher(app: Flask) -> None: # noqa: C901 """Set up file watcher for LOCAL_EXTENSIONS directories.""" + global _watcher_initialized + + # Prevent multiple initializations + with _watcher_lock: + if _watcher_initialized: + return + _watcher_initialized = True + # Only set up watcher in debug mode or when Flask reloader is enabled if not (app.debug or app.config.get("FLASK_USE_RELOAD", False)): return diff --git a/superset/extensions/types.py b/superset/extensions/types.py index 07d7a317b6e..3f137abcddf 100644 --- a/superset/extensions/types.py +++ b/superset/extensions/types.py @@ -34,3 +34,6 @@ class LoadedExtension: frontend: dict[str, bytes] backend: dict[str, bytes] version: str + source_base_path: ( + str # Base path for traceback filenames (absolute path or supx:// URL) + ) diff --git a/superset/extensions/utils.py b/superset/extensions/utils.py index d885676d4dd..883c9114728 100644 --- a/superset/extensions/utils.py +++ b/superset/extensions/utils.py @@ -55,15 +55,30 @@ class InMemoryLoader(importlib.abc.Loader): ) if self.is_package: module.__path__ = [] - exec(self.source, module.__dict__) # noqa: S102 + # Compile with filename for proper tracebacks + code = compile(self.source, self.origin, "exec") + exec(code, module.__dict__) # noqa: S102 class InMemoryFinder(importlib.abc.MetaPathFinder): - def __init__(self, file_dict: dict[str, bytes]) -> None: + def __init__(self, file_dict: dict[str, bytes], source_base_path: str) -> None: self.modules: dict[str, Tuple[Any, Any, Any]] = {} + + # Detect if this is a virtual path (supx://) or filesystem path + is_virtual_path = source_base_path.startswith("supx://") + for path, content in file_dict.items(): mod_name, is_package = self._get_module_name(path) - self.modules[mod_name] = (content, is_package, path) + + # Reconstruct full path for tracebacks + if is_virtual_path: + # Virtual paths always use forward slashes + # e.g., supx://extension-id/backend/src/tasks.py + full_path = f"{source_base_path}/backend/src/{path}" + else: + full_path = str(Path(source_base_path) / "backend" / "src" / path) + + self.modules[mod_name] = (content, is_package, full_path) def _get_module_name(self, file_path: str) -> Tuple[str, bool]: parts = list(Path(file_path).parts) @@ -88,8 +103,19 @@ class InMemoryFinder(importlib.abc.MetaPathFinder): return None -def install_in_memory_importer(file_dict: dict[str, bytes]) -> None: - finder = InMemoryFinder(file_dict) +def install_in_memory_importer( + file_dict: dict[str, bytes], source_base_path: str +) -> None: + """ + Install an in-memory module importer for extension backend code. + + :param file_dict: Dictionary mapping relative file paths to their content + :param source_base_path: Base path for traceback filenames. For LOCAL_EXTENSIONS, + this should be an absolute filesystem path to the dist directory. + For EXTENSIONS_PATH (.supx files), this should be a supx:// URL + (e.g., "supx://extension-id"). + """ + finder = InMemoryFinder(file_dict, source_base_path) sys.meta_path.insert(0, finder) @@ -121,7 +147,19 @@ def get_bundle_files_from_path(base_path: str) -> Generator[BundleFile, None, No yield BundleFile(name=rel_path, content=content) -def get_loaded_extension(files: Iterable[BundleFile]) -> LoadedExtension: +def get_loaded_extension( + files: Iterable[BundleFile], source_base_path: str +) -> LoadedExtension: + """ + Load an extension from bundle files. + + :param files: Iterable of BundleFile objects containing the extension files + :param source_base_path: Base path for traceback filenames. For LOCAL_EXTENSIONS, + this should be an absolute filesystem path to the dist directory. + For EXTENSIONS_PATH (.supx files), this should be a supx:// URL + (e.g., "supx://extension-id"). + :returns: LoadedExtension instance + """ manifest: Manifest | None = None frontend: dict[str, bytes] = {} backend: dict[str, bytes] = {} @@ -158,6 +196,7 @@ def get_loaded_extension(files: Iterable[BundleFile]) -> LoadedExtension: frontend=frontend, backend=backend, version=manifest.version, + source_base_path=source_base_path, ) @@ -190,7 +229,9 @@ def get_extensions() -> dict[str, LoadedExtension]: # Load extensions from LOCAL_EXTENSIONS configuration (filesystem paths) for path in current_app.config["LOCAL_EXTENSIONS"]: files = get_bundle_files_from_path(path) - extension = get_loaded_extension(files) + # Use absolute filesystem path to dist directory for tracebacks + abs_dist_path = str((Path(path) / "dist").resolve()) + extension = get_loaded_extension(files, source_base_path=abs_dist_path) extension_id = extension.manifest.id extensions[extension_id] = extension logger.info( diff --git a/superset/initialization/__init__.py b/superset/initialization/__init__.py index 1f18f7da0cd..adc783c1e12 100644 --- a/superset/initialization/__init__.py +++ b/superset/initialization/__init__.py @@ -562,7 +562,10 @@ class SupersetAppInitializer: # pylint: disable=too-many-public-methods for extension in extensions.values(): if backend_files := extension.backend: - install_in_memory_importer(backend_files) + install_in_memory_importer( + backend_files, + source_base_path=extension.source_base_path, + ) backend = extension.manifest.backend diff --git a/superset/mcp_service/app.py b/superset/mcp_service/app.py index 64730a54caa..4a8fc4e729f 100644 --- a/superset/mcp_service/app.py +++ b/superset/mcp_service/app.py @@ -349,9 +349,8 @@ def init_fastmcp_server( """ Initialize and configure the FastMCP server. - This function provides a way to create a custom FastMCP instance - instead of using the default global one. If parameters are provided, - a new instance will be created with those settings. + This function configures the global MCP instance (which has all tools + already registered) with auth, middleware, and other settings. Args: name: Server name (defaults to "{APP_NAME} MCP Server") @@ -361,7 +360,7 @@ def init_fastmcp_server( **kwargs: Additional FastMCP configuration Returns: - FastMCP instance (either the global one or a new custom one) + The global FastMCP instance configured with the provided settings """ # Read branding from Flask config's APP_NAME from superset.mcp_service.flask_singleton import app as flask_app @@ -377,38 +376,32 @@ def init_fastmcp_server( if instructions is None: instructions = get_default_instructions(branding) - # If any custom parameters are provided, create a new instance - custom_params_provided = any( - [ - name != default_name, - instructions != get_default_instructions(branding), - auth is not None, - lifespan is not None, - tools is not None, - include_tags is not None, - exclude_tags is not None, - config is not None, - middleware is not None, - kwargs, - ] - ) + # Configure the global mcp instance with provided settings. + # Tools are already registered on this instance via @tool decorator imports above. + # name and instructions are read-only properties that delegate to _mcp_server + mcp._mcp_server.name = name + mcp._mcp_server.instructions = instructions - if custom_params_provided: - logger.info("Creating custom FastMCP instance with provided configuration") - return create_mcp_app( - name=name, - instructions=instructions, - auth=auth, - lifespan=lifespan, - tools=tools, - include_tags=include_tags, - exclude_tags=exclude_tags, - config=config, - middleware=middleware, - **kwargs, - ) - else: - # Use the default global instance - logger.setLevel(logging.DEBUG) - logger.info("Using default FastMCP instance - scaffold version without auth") - return mcp + if auth is not None: + mcp.auth = auth + logger.info("Authentication configured on MCP instance") + + if middleware is not None: + for mw in middleware: + mcp.add_middleware(mw) + logger.info("Added %d middleware(s) to MCP instance", len(middleware)) + + if lifespan is not None: + mcp.lifespan = lifespan + + if include_tags is not None: + mcp.include_tags = include_tags + + if exclude_tags is not None: + mcp.exclude_tags = exclude_tags + + # Apply any additional configuration + _apply_config(mcp, config) + + logger.info("Configured FastMCP instance: %s (auth=%s)", name, auth is not None) + return mcp diff --git a/superset/mcp_service/auth.py b/superset/mcp_service/auth.py index 2ffc94ebe44..326254acb2e 100644 --- a/superset/mcp_service/auth.py +++ b/superset/mcp_service/auth.py @@ -127,14 +127,22 @@ def has_dataset_access(dataset: "SqlaTable") -> bool: return False # Deny access on error -def _setup_user_context() -> User: +def _setup_user_context() -> User | None: """ Set up user context for MCP tool execution. Returns: - User object with roles and groups loaded + User object with roles and groups loaded, or None if no Flask context """ - user = get_user_from_request() + try: + user = get_user_from_request() + except RuntimeError as e: + # No Flask application context (e.g., prompts before middleware runs) + # This is expected for some FastMCP operations - return None gracefully + if "application context" in str(e): + logger.debug("No Flask app context available for user setup") + return None + raise # Validate user has necessary relationships loaded # (Force access to ensure they're loaded if lazy) @@ -212,6 +220,15 @@ def mcp_auth_hook(tool_func: F) -> F: # noqa: C901 with _get_app_context_manager(): user = _setup_user_context() + # No Flask context - this is a FastMCP internal operation + # (e.g., tool discovery, prompt listing) that doesn't require auth + if user is None: + logger.debug( + "MCP internal call without Flask context: tool=%s", + tool_func.__name__, + ) + return await tool_func(*args, **kwargs) + try: logger.debug( "MCP tool call: user=%s, tool=%s", @@ -235,6 +252,15 @@ def mcp_auth_hook(tool_func: F) -> F: # noqa: C901 with _get_app_context_manager(): user = _setup_user_context() + # No Flask context - this is a FastMCP internal operation + # (e.g., tool discovery, prompt listing) that doesn't require auth + if user is None: + logger.debug( + "MCP internal call without Flask context: tool=%s", + tool_func.__name__, + ) + return tool_func(*args, **kwargs) + try: logger.debug( "MCP tool call: user=%s, tool=%s", diff --git a/superset/mcp_service/chart/chart_utils.py b/superset/mcp_service/chart/chart_utils.py index 633e3c6a9c6..4597ac55b50 100644 --- a/superset/mcp_service/chart/chart_utils.py +++ b/superset/mcp_service/chart/chart_utils.py @@ -139,8 +139,9 @@ def map_table_config(config: TableChartConfig) -> Dict[str, Any]: if not raw_columns and not aggregated_metrics: raise ValueError("Table chart configuration resulted in no displayable columns") + # Use the viz_type from config (defaults to "table", can be "ag-grid-table") form_data: Dict[str, Any] = { - "viz_type": "table", + "viz_type": config.viz_type, } # Handle raw columns (no aggregation) @@ -289,6 +290,10 @@ def map_xy_config(config: XYChartConfig) -> Dict[str, Any]: "metrics": metrics, } + # Add time grain if specified (for temporal x-axis columns) + if config.time_grain: + form_data["time_grain_sqla"] = config.time_grain + # CRITICAL FIX: For time series charts, handle groupby carefully to avoid duplicates # The x_axis field already tells Superset which column to use for time grouping groupby_columns = [] @@ -320,6 +325,10 @@ def map_xy_config(config: XYChartConfig) -> Dict[str, Any]: if filter_config is not None ] + # Add stacking configuration + if getattr(config, "stacked", False): + form_data["stack"] = "Stack" + # Add configurations add_axis_config(form_data, config) add_legend_config(form_data, config) @@ -370,7 +379,8 @@ def analyze_chart_capabilities(chart: Any | None, config: Any) -> ChartCapabilit } viz_type = viz_type_map.get(kind, "echarts_timeseries_line") elif chart_type == "table": - viz_type = "table" + # Use the viz_type from config if available (table or ag-grid-table) + viz_type = getattr(config, "viz_type", "table") else: viz_type = "unknown" @@ -382,10 +392,11 @@ def analyze_chart_capabilities(chart: Any | None, config: Any) -> ChartCapabilit "echarts_timeseries_scatter", "deck_scatter", "deck_hex", + "ag-grid-table", # AG Grid tables are interactive ] supports_interaction = viz_type in interactive_types - supports_drill_down = viz_type in ["table", "pivot_table_v2"] + supports_drill_down = viz_type in ["table", "pivot_table_v2", "ag-grid-table"] supports_real_time = viz_type in [ "echarts_timeseries_line", "echarts_timeseries_bar", @@ -433,7 +444,8 @@ def analyze_chart_semantics(chart: Any | None, config: Any) -> ChartSemantics: } viz_type = viz_type_map.get(kind, "echarts_timeseries_line") elif chart_type == "table": - viz_type = "table" + # Use the viz_type from config if available (table or ag-grid-table) + viz_type = getattr(config, "viz_type", "table") else: viz_type = "unknown" @@ -442,6 +454,10 @@ def analyze_chart_semantics(chart: Any | None, config: Any) -> ChartSemantics: "echarts_timeseries_line": "Shows trends and changes over time", "echarts_timeseries_bar": "Compares values across categories or time periods", "table": "Displays detailed data in tabular format", + "ag-grid-table": ( + "Interactive table with advanced features like column resizing, " + "sorting, filtering, and server-side pagination" + ), "pie": "Shows proportional relationships within a dataset", "echarts_area": "Emphasizes cumulative totals and part-to-whole relationships", } diff --git a/superset/mcp_service/chart/schemas.py b/superset/mcp_service/chart/schemas.py index cecd34e85e7..928858aea12 100644 --- a/superset/mcp_service/chart/schemas.py +++ b/superset/mcp_service/chart/schemas.py @@ -36,6 +36,7 @@ from pydantic import ( PositiveInt, ) +from superset.constants import TimeGrain from superset.daos.base import ColumnOperator, ColumnOperatorEnum from superset.mcp_service.common.cache_schemas import ( CacheStatus, @@ -211,13 +212,13 @@ def serialize_chart_object(chart: ChartLike | None) -> ChartInfo | None: if not chart: return None - # Generate MCP service screenshot URL instead of chart's native URL - from superset.mcp_service.utils.url_utils import get_chart_screenshot_url + # Use the chart's native URL (explore URL) instead of screenshot URL + from superset.mcp_service.utils.url_utils import get_superset_base_url chart_id = getattr(chart, "id", None) - screenshot_url = None + chart_url = None if chart_id: - screenshot_url = get_chart_screenshot_url(chart_id) + chart_url = f"{get_superset_base_url()}/explore/?slice_id={chart_id}" return ChartInfo( id=chart_id, @@ -225,7 +226,7 @@ def serialize_chart_object(chart: ChartLike | None) -> ChartInfo | None: viz_type=getattr(chart, "viz_type", None), datasource_name=getattr(chart, "datasource_name", None), datasource_type=getattr(chart, "datasource_type", None), - url=screenshot_url, + url=chart_url, description=getattr(chart, "description", None), cache_timeout=getattr(chart, "cache_timeout", None), form_data=getattr(chart, "form_data", None), @@ -608,6 +609,14 @@ class TableChartConfig(BaseModel): chart_type: Literal["table"] = Field( ..., description="Chart type (REQUIRED: must be 'table')" ) + viz_type: Literal["table", "ag-grid-table"] = Field( + "table", + description=( + "Visualization type: 'table' for standard table, 'ag-grid-table' for " + "AG Grid Interactive Table with advanced features like column resizing, " + "sorting, filtering, and server-side pagination" + ), + ) columns: List[ColumnRef] = Field( ..., min_length=1, @@ -670,6 +679,19 @@ class XYChartConfig(BaseModel): kind: Literal["line", "bar", "area", "scatter"] = Field( "line", description="Chart visualization type" ) + time_grain: TimeGrain | None = Field( + None, + description=( + "Time granularity for the x-axis when it's a temporal column. " + "Common values: PT1S (second), PT1M (minute), PT1H (hour), " + "P1D (day), P1W (week), P1M (month), P3M (quarter), P1Y (year). " + "If not specified, Superset will use its default behavior." + ), + ) + stacked: bool = Field( + False, + description="Stack bars/areas on top of each other instead of side-by-side", + ) group_by: ColumnRef | None = Field(None, description="Column to group by") x_axis: AxisConfig | None = Field(None, description="X-axis configuration") y_axis: AxisConfig | None = Field(None, description="Y-axis configuration") diff --git a/superset/mcp_service/chart/tool/generate_chart.py b/superset/mcp_service/chart/tool/generate_chart.py index ba444ebb6eb..9cd6e622584 100644 --- a/superset/mcp_service/chart/tool/generate_chart.py +++ b/superset/mcp_service/chart/tool/generate_chart.py @@ -37,13 +37,9 @@ from superset.mcp_service.chart.schemas import ( GenerateChartRequest, GenerateChartResponse, PerformanceMetadata, - URLPreview, ) from superset.mcp_service.utils.schema_utils import parse_request -from superset.mcp_service.utils.url_utils import ( - get_chart_screenshot_url, - get_superset_base_url, -) +from superset.mcp_service.utils.url_utils import get_superset_base_url from superset.utils import json logger = logging.getLogger(__name__) @@ -60,7 +56,6 @@ async def generate_chart( # noqa: C901 - Charts are NOT saved by default (save_chart=False) - preview only - Set save_chart=True to permanently save the chart - LLM clients MUST display returned chart URL to users - - Embed preview_url as image: ![Chart Preview](preview_url) - Use numeric dataset ID or UUID (NOT schema.table_name format) - MUST include chart_type in config (either 'xy' or 'table') @@ -397,20 +392,9 @@ async def generate_chart( # noqa: C901 previews[format_type] = preview_result.content else: # For preview-only mode (save_chart=false) - if format_type == "url" and form_data_key: - # Generate screenshot URL using centralized helper - from superset.mcp_service.utils.url_utils import ( - get_explore_screenshot_url, - ) - - preview_url = get_explore_screenshot_url(form_data_key) - previews[format_type] = URLPreview( - preview_url=preview_url, - width=800, - height=600, - supports_interaction=False, - ) - elif format_type in ["ascii", "table", "vega_lite"]: + # Note: Screenshot-based URL previews are not supported. + # Use the explore_url to view the chart interactively. + if format_type in ["ascii", "table", "vega_lite"]: # Generate preview from form data without saved chart from superset.mcp_service.chart.preview_utils import ( generate_preview_from_form_data, @@ -483,7 +467,6 @@ async def generate_chart( # noqa: C901 "data": f"{get_superset_base_url()}/api/v1/chart/{chart.id}/data/" if chart else None, - "preview": get_chart_screenshot_url(chart.id) if chart else None, "export": f"{get_superset_base_url()}/api/v1/chart/{chart.id}/export/" if chart else None, diff --git a/superset/mcp_service/chart/tool/get_chart_preview.py b/superset/mcp_service/chart/tool/get_chart_preview.py index c2c33a83eb9..2b3ecf353e7 100644 --- a/superset/mcp_service/chart/tool/get_chart_preview.py +++ b/superset/mcp_service/chart/tool/get_chart_preview.py @@ -72,53 +72,17 @@ class URLPreviewStrategy(PreviewFormatStrategy): """Generate URL-based image preview.""" def generate(self) -> URLPreview | ChartError: - try: - from flask import g - - from superset.mcp_service.screenshot.pooled_screenshot import ( - PooledChartScreenshot, - ) - from superset.mcp_service.utils.url_utils import get_superset_base_url - - # Check if chart.id is None - if self.chart.id is None: - return ChartError( - error="Chart has no ID - cannot generate URL preview", - error_type="InvalidChart", - ) - - # Use configured Superset base URL instead of Flask's url_for - # which may not respect SUPERSET_WEBSERVER_ADDRESS - base_url = get_superset_base_url() - chart_url = f"{base_url}/superset/slice/{self.chart.id}/" - screenshot = PooledChartScreenshot(chart_url, self.chart.digest) - - window_size = (self.request.width or 800, self.request.height or 600) - image_data = screenshot.get_screenshot(user=g.user, window_size=window_size) - - if image_data: - # Use the MCP service screenshot URL via centralized helper - from superset.mcp_service.utils.url_utils import ( - get_chart_screenshot_url, - ) - - preview_url = get_chart_screenshot_url(self.chart.id) - - return URLPreview( - preview_url=preview_url, - width=self.request.width or 800, - height=self.request.height or 600, - ) - else: - return ChartError( - error=f"Could not generate screenshot for chart {self.chart.id}", - error_type="ScreenshotError", - ) - except Exception as e: - logger.error("URL preview generation failed: %s", e) - return ChartError( - error=f"Failed to generate URL preview: {str(e)}", error_type="URLError" - ) + # Screenshot-based URL previews are not supported. + # Users should use the explore_url to view the chart interactively, + # or use other preview formats like 'ascii', 'table', or 'vega_lite'. + return ChartError( + error=( + "URL-based screenshot previews are not supported. " + "Use the explore_url to view the chart interactively, " + "or try formats: 'ascii', 'table', or 'vega_lite'." + ), + error_type="UnsupportedFormat", + ) # Base64 preview support removed - we never return base64 data @@ -479,7 +443,7 @@ class VegaLitePreviewStrategy(PreviewFormatStrategy): except Exception as e: logger.warning("Error in field type analysis: %s", e) # Return nominal types for all fields as fallback - return {field: "nominal" for field in fields} + return dict.fromkeys(fields, "nominal") return field_types diff --git a/superset/mcp_service/chart/tool/list_charts.py b/superset/mcp_service/chart/tool/list_charts.py index 9831a8d4bab..37ddbcfc503 100644 --- a/superset/mcp_service/chart/tool/list_charts.py +++ b/superset/mcp_service/chart/tool/list_charts.py @@ -137,20 +137,17 @@ async def list_charts(request: ListChartsRequest, ctx: Context) -> ChartList: % (count, total_pages) ) - # Apply field filtering via serialization context if select_columns specified + # Apply field filtering via serialization context + # Always use columns_requested (either explicit select_columns or defaults) # This triggers ChartInfo._filter_fields_by_context for each chart - if request.select_columns: - await ctx.debug( - "Applying field filtering via serialization context: select_columns=%s" - % (request.select_columns,) - ) - # Return dict with context - FastMCP handles serialization - return result.model_dump( - mode="json", context={"select_columns": request.select_columns} - ) - - # No filtering - return full result as dict - return result.model_dump(mode="json") + columns_to_filter = result.columns_requested + await ctx.debug( + "Applying field filtering via serialization context: columns=%s" + % (columns_to_filter,) + ) + return result.model_dump( + mode="json", context={"select_columns": columns_to_filter} + ) except Exception as e: await ctx.error("Failed to list charts: %s" % (str(e),)) raise diff --git a/superset/mcp_service/chart/tool/update_chart.py b/superset/mcp_service/chart/tool/update_chart.py index 13b9630a0f2..ed5355906ff 100644 --- a/superset/mcp_service/chart/tool/update_chart.py +++ b/superset/mcp_service/chart/tool/update_chart.py @@ -38,10 +38,7 @@ from superset.mcp_service.chart.schemas import ( UpdateChartRequest, ) from superset.mcp_service.utils.schema_utils import parse_request -from superset.mcp_service.utils.url_utils import ( - get_chart_screenshot_url, - get_superset_base_url, -) +from superset.mcp_service.utils.url_utils import get_superset_base_url from superset.utils import json logger = logging.getLogger(__name__) @@ -57,7 +54,6 @@ async def update_chart( IMPORTANT: - Chart must already be saved (from generate_chart with save_chart=True) - LLM clients MUST display updated chart URL to users - - Embed preview_url as image: ![Updated Chart](preview_url) - Use numeric ID or UUID string to identify the chart (NOT chart name) - MUST include chart_type in config (either 'xy' or 'table') @@ -222,7 +218,6 @@ async def update_chart( "data": ( f"{get_superset_base_url()}/api/v1/chart/{updated_chart.id}/data/" ), - "preview": get_chart_screenshot_url(updated_chart.id), "export": ( f"{get_superset_base_url()}/api/v1/chart/{updated_chart.id}/export/" ), diff --git a/superset/mcp_service/chart/tool/update_chart_preview.py b/superset/mcp_service/chart/tool/update_chart_preview.py index 295d08ab20e..271709e230f 100644 --- a/superset/mcp_service/chart/tool/update_chart_preview.py +++ b/superset/mcp_service/chart/tool/update_chart_preview.py @@ -37,10 +37,8 @@ from superset.mcp_service.chart.schemas import ( AccessibilityMetadata, PerformanceMetadata, UpdateChartPreviewRequest, - URLPreview, ) from superset.mcp_service.utils.schema_utils import parse_request -from superset.mcp_service.utils.url_utils import get_mcp_service_url logger = logging.getLogger(__name__) @@ -56,7 +54,6 @@ def update_chart_preview( - Modifies cached form_data from generate_chart (save_chart=False) - Original form_data_key is invalidated, new one returned - LLM clients MUST display explore_url to users - - Embed preview_url as image: ![Chart Preview](preview_url) Use when: - Modifying preview before deciding to save @@ -99,30 +96,9 @@ def update_chart_preview( high_contrast_available=False, ) - # Generate previews if requested - previews = {} - if request.generate_preview and new_form_data_key: - try: - for format_type in request.preview_formats: - if format_type == "url": - # Generate screenshot URL using new form_data key - mcp_base = get_mcp_service_url() - preview_url = ( - f"{mcp_base}/screenshot/explore/{new_form_data_key}.png" - ) - - previews[format_type] = URLPreview( - preview_url=preview_url, - width=800, - height=600, - supports_interaction=False, - ) - # Other formats would need form_data execution - # which is more complex for preview-only mode - - except Exception as e: - # Log warning but don't fail the entire request - logger.warning("Preview generation failed: %s", e) + # Note: Screenshot-based previews are not supported. + # Use the explore_url to view the chart interactively. + previews: Dict[str, Any] = {} # Return enhanced data result = { diff --git a/superset/mcp_service/dashboard/tool/list_dashboards.py b/superset/mcp_service/dashboard/tool/list_dashboards.py index ecb3433cefd..db0a30da945 100644 --- a/superset/mcp_service/dashboard/tool/list_dashboards.py +++ b/superset/mcp_service/dashboard/tool/list_dashboards.py @@ -139,17 +139,12 @@ async def list_dashboards( % (count, total_pages) ) - # Apply field filtering via serialization context if select_columns specified + # Apply field filtering via serialization context + # Always use columns_requested (either explicit select_columns or defaults) # This triggers DashboardInfo._filter_fields_by_context for each dashboard - if request.select_columns: - await ctx.debug( - "Applying field filtering via serialization context: select_columns=%s" - % (request.select_columns,) - ) - # Return dict with context - FastMCP handles serialization - return result.model_dump( - mode="json", context={"select_columns": request.select_columns} - ) - - # No filtering - return full result as dict - return result.model_dump(mode="json") + columns_to_filter = result.columns_requested + await ctx.debug( + "Applying field filtering via serialization context: columns=%s" + % (columns_to_filter,) + ) + return result.model_dump(mode="json", context={"select_columns": columns_to_filter}) diff --git a/superset/mcp_service/dataset/tool/list_datasets.py b/superset/mcp_service/dataset/tool/list_datasets.py index 897d7f613d6..4d81f13eb03 100644 --- a/superset/mcp_service/dataset/tool/list_datasets.py +++ b/superset/mcp_service/dataset/tool/list_datasets.py @@ -148,20 +148,17 @@ async def list_datasets(request: ListDatasetsRequest, ctx: Context) -> DatasetLi ) ) - # Apply field filtering via serialization context if select_columns specified + # Apply field filtering via serialization context + # Always use columns_requested (either explicit select_columns or defaults) # This triggers DatasetInfo._filter_fields_by_context for each dataset - if request.select_columns: - await ctx.debug( - "Applying field filtering via serialization context: select_columns=%s" - % (request.select_columns,) - ) - # Return dict with context - FastMCP handles serialization - return result.model_dump( - mode="json", context={"select_columns": request.select_columns} - ) - - # No filtering - return full result as dict - return result.model_dump(mode="json") + columns_to_filter = result.columns_requested + await ctx.debug( + "Applying field filtering via serialization context: columns=%s" + % (columns_to_filter,) + ) + return result.model_dump( + mode="json", context={"select_columns": columns_to_filter} + ) except Exception as e: await ctx.error( diff --git a/superset/mcp_service/flask_singleton.py b/superset/mcp_service/flask_singleton.py index d508943e865..3c35d31a6a4 100644 --- a/superset/mcp_service/flask_singleton.py +++ b/superset/mcp_service/flask_singleton.py @@ -27,7 +27,7 @@ Following the Stack Overflow recommendation: import logging import os -from flask import Flask +from flask import current_app, Flask, has_app_context logger = logging.getLogger(__name__) @@ -39,16 +39,37 @@ try: # Check if appbuilder is already initialized (main Superset app is running). # If so, reuse that app to avoid corrupting the shared appbuilder singleton. # Calling create_app() again would re-initialize appbuilder and break views. - if appbuilder.app is not None: - logger.info("Reusing existing Flask app from appbuilder for MCP service") - app = appbuilder.app + # + # NOTE: appbuilder.app now returns a LocalProxy to current_app (Flask-AppBuilder + # deprecation), so we can't use `appbuilder.app is not None` as that always + # returns True (compares LocalProxy object, not the resolved value). + # Instead, check if init_app was called by looking at _session. + appbuilder_initialized = appbuilder._session is not None + + if appbuilder_initialized and has_app_context(): + # We're in an app context (e.g., during main Superset startup), + # so we can get the actual Flask app instance from current_app + logger.info("Reusing existing Flask app from app context for MCP service") + # Use _get_current_object() to get the actual Flask app, not the LocalProxy + app = current_app._get_current_object() else: - # Create a minimal Flask app for standalone MCP server. + # Either appbuilder is not initialized (standalone MCP server), + # or appbuilder is initialized but we're not in an app context + # (edge case - should rarely happen). In both cases, create a minimal app. + # # We avoid calling create_app() which would run full FAB initialization # and could corrupt the shared appbuilder singleton if main app starts. from superset.app import SupersetApp from superset.mcp_service.mcp_config import get_mcp_config + if appbuilder_initialized: + logger.warning( + "Appbuilder initialized but not in app context - " + "creating separate MCP Flask app" + ) + else: + logger.info("Creating minimal Flask app for standalone MCP service") + # Disable debug mode to avoid side-effects like file watchers _mcp_app = SupersetApp(__name__) _mcp_app.debug = False diff --git a/superset/mcp_service/mcp_config.py b/superset/mcp_service/mcp_config.py index c8e9435eac7..5e9432bb4b0 100644 --- a/superset/mcp_service/mcp_config.py +++ b/superset/mcp_service/mcp_config.py @@ -126,12 +126,22 @@ MCP_FACTORY_CONFIG = { # ============================================================================= # MCP Store Configuration - shared Redis infrastructure for all MCP storage needs -# (caching, auth, events, etc.). Only used when a consumer explicitly requests it. +# (caching, auth, events, session state, etc.). +# +# When CACHE_REDIS_URL is set: +# - Response caching uses Redis (if MCP_CACHE_CONFIG enabled) +# - EventStore uses Redis for multi-pod session management +# +# For multi-pod/Kubernetes deployments, setting CACHE_REDIS_URL automatically +# enables Redis-backed EventStore to share session state across pods. MCP_STORE_CONFIG: Dict[str, Any] = { "enabled": False, # Disabled by default - caching uses in-memory store "CACHE_REDIS_URL": None, # Redis URL, e.g., "redis://localhost:6379/0" # Wrapper class that prefixes all keys. Each consumer provides their own prefix. "WRAPPER_TYPE": "key_value.aio.wrappers.prefix_keys.PrefixKeysWrapper", + # EventStore settings (for multi-pod session management) + "event_store_max_events": 100, # Keep last 100 events per session + "event_store_ttl": 3600, # Events expire after 1 hour } # MCP Response Caching Configuration - controls caching behavior and TTLs @@ -170,21 +180,21 @@ def create_default_mcp_auth_factory(app: Flask) -> Optional[Any]: return None try: - from fastmcp.server.auth.providers.bearer import BearerAuthProvider + from fastmcp.server.auth.providers.jwt import JWTVerifier # For HS256 (symmetric), use the secret as the public_key parameter if app.config.get("MCP_JWT_ALGORITHM") == "HS256" and secret: - auth_provider = BearerAuthProvider( + auth_provider = JWTVerifier( public_key=secret, # HS256 uses secret as key issuer=app.config.get("MCP_JWT_ISSUER"), audience=app.config.get("MCP_JWT_AUDIENCE"), algorithm="HS256", required_scopes=app.config.get("MCP_REQUIRED_SCOPES", []), ) - logger.info("Created BearerAuthProvider with HS256 secret") + logger.info("Created JWTVerifier with HS256 secret") else: # For RS256 (asymmetric), use public key or JWKS - auth_provider = BearerAuthProvider( + auth_provider = JWTVerifier( jwks_uri=jwks_uri, public_key=public_key, issuer=app.config.get("MCP_JWT_ISSUER"), @@ -193,7 +203,7 @@ def create_default_mcp_auth_factory(app: Flask) -> Optional[Any]: required_scopes=app.config.get("MCP_REQUIRED_SCOPES", []), ) logger.info( - "Created BearerAuthProvider with jwks_uri=%s, public_key=%s", + "Created JWTVerifier with jwks_uri=%s, public_key=%s", jwks_uri, "***" if public_key else None, ) diff --git a/superset/mcp_service/server.py b/superset/mcp_service/server.py index 8ca289446cb..c159c6cb3b2 100644 --- a/superset/mcp_service/server.py +++ b/superset/mcp_service/server.py @@ -17,13 +17,23 @@ """ MCP server for Apache Superset + +Supports both single-pod (in-memory) and multi-pod (Redis) deployments. +For multi-pod deployments, configure MCP_EVENT_STORE_CONFIG with Redis URL. """ import logging import os +from typing import Any + +import uvicorn from superset.mcp_service.app import create_mcp_app, init_fastmcp_server -from superset.mcp_service.mcp_config import get_mcp_factory_config +from superset.mcp_service.mcp_config import ( + get_mcp_factory_config, + MCP_STORE_CONFIG, +) +from superset.mcp_service.storage import _create_redis_store def configure_logging(debug: bool = False) -> None: @@ -55,21 +65,83 @@ def configure_logging(debug: bool = False) -> None: logging.info("🔍 SQL Debug logging enabled") +def create_event_store(config: dict[str, Any] | None = None) -> Any | None: + """ + Create an EventStore for MCP session management. + + For multi-pod deployments, uses Redis-backed storage to share session state + across pods. For single-pod deployments, returns None (uses in-memory). + + Args: + config: Optional config dict. If None, reads from MCP_STORE_CONFIG. + + Returns: + EventStore instance if Redis URL is configured, None otherwise. + """ + if config is None: + config = MCP_STORE_CONFIG + + redis_url = config.get("CACHE_REDIS_URL") + if not redis_url: + logging.info("EventStore: Using in-memory storage (single-pod mode)") + return None + + try: + from fastmcp.server.event_store import EventStore + + # Get prefix from config (allows Preset to customize for multi-tenancy) + # Default prefix prevents key collisions in shared Redis environments + prefix = config.get("event_store_prefix", "mcp_events_") + + # Create wrapped Redis store with prefix for key namespacing + redis_store = _create_redis_store(config, prefix=prefix, wrap=True) + if redis_store is None: + logging.warning("Failed to create Redis store, falling back to in-memory") + return None + + # Create EventStore with Redis backend + event_store = EventStore( + storage=redis_store, + max_events_per_stream=config.get("event_store_max_events", 100), + ttl=config.get("event_store_ttl", 3600), + ) + + logging.info("EventStore: Using Redis storage (multi-pod mode)") + return event_store + + except ImportError as e: + logging.error( + "Failed to import EventStore dependencies: %s. " + "Ensure fastmcp package is installed.", + e, + ) + return None + except Exception as e: + logging.error("Failed to create Redis EventStore: %s", e) + return None + + def run_server( host: str = "127.0.0.1", port: int = 5008, debug: bool = False, use_factory_config: bool = False, + event_store_config: dict[str, Any] | None = None, ) -> None: """ Run the MCP service server with FastMCP endpoints. Uses streamable-http transport for HTTP server mode. + For multi-pod deployments, configure MCP_EVENT_STORE_CONFIG with Redis URL + to share session state across pods. + Args: host: Host to bind to port: Port to bind to debug: Enable debug logging use_factory_config: Use configuration from get_mcp_factory_config() + event_store_config: Optional EventStore configuration dict. + If None, reads from MCP_EVENT_STORE_CONFIG. """ configure_logging(debug) @@ -113,14 +185,33 @@ def run_server( middleware=middleware_list or None, ) + # Create EventStore for session management (Redis for multi-pod, None for in-memory) + event_store = create_event_store(event_store_config) + env_key = f"FASTMCP_RUNNING_{port}" if not os.environ.get(env_key): os.environ[env_key] = "1" try: logging.info("Starting FastMCP on %s:%s", host, port) - mcp_instance.run( - transport="streamable-http", host=host, port=port, stateless_http=True - ) + + if event_store is not None: + # Multi-pod: Use http_app with Redis EventStore, run with uvicorn + logging.info("Running in multi-pod mode with Redis EventStore") + app = mcp_instance.http_app( + transport="streamable-http", + event_store=event_store, + stateless_http=True, + ) + uvicorn.run(app, host=host, port=port) + else: + # Single-pod mode: Use built-in run() with in-memory sessions + logging.info("Running in single-pod mode with in-memory sessions") + mcp_instance.run( + transport="streamable-http", + host=host, + port=port, + stateless_http=True, + ) except Exception as e: logging.error("FastMCP failed: %s", e) os.environ.pop(env_key, None) diff --git a/superset/mcp_service/storage.py b/superset/mcp_service/storage.py index 47d19b0eb7a..b4c06a2758a 100644 --- a/superset/mcp_service/storage.py +++ b/superset/mcp_service/storage.py @@ -27,6 +27,9 @@ Reusable across caching middleware, OAuth providers, EventStore, etc. import logging from importlib import import_module from typing import Any, Callable, Dict +from urllib.parse import urlparse + +from redis.asyncio import Redis logger = logging.getLogger(__name__) @@ -82,17 +85,21 @@ def get_mcp_store( def _create_redis_store( store_config: Dict[str, Any], - prefix: str | Callable[[], str], + prefix: str | Callable[[], str] | None = None, + wrap: bool = True, ) -> Any | None: """ - Create a RedisStore with the given prefix. + Create a RedisStore, optionally wrapped with a prefix. + + Handles SSL/TLS connections (rediss:// scheme) for cloud deployments. Args: store_config: MCP_STORE_CONFIG dict (Redis URL, wrapper type) - prefix: Feature-specific prefix + prefix: Feature-specific prefix (required if wrap=True) + wrap: If True, wrap store with prefix. If False, return raw RedisStore. Returns: - Wrapped RedisStore instance or None if not configured + RedisStore instance (wrapped or raw) or None if not configured """ redis_url = store_config.get("CACHE_REDIS_URL") if not redis_url: @@ -109,15 +116,67 @@ def _create_redis_store( return None try: + # Parse URL to handle SSL properly + parsed = urlparse(redis_url) + use_ssl = parsed.scheme == "rediss" + + # RedisStore doesn't handle SSL from URL - it parses URL manually + # and ignores the scheme. We must create the Redis client ourselves. + + db = 0 + if parsed.path and parsed.path != "/": + try: + db = int(parsed.path.strip("/")) + except ValueError: + db = 0 + + redis_client: Redis[str] + if use_ssl: + # For ElastiCache with self-signed certs, disable cert verification. + # NOTE: ssl_cert_reqs="none" disables certificate verification. + # Do not use Python None - that would default to CERT_REQUIRED. + redis_client = Redis( + host=parsed.hostname or "localhost", + port=parsed.port or 6379, + db=db, + username=parsed.username, # Support Redis 6+ ACLs + password=parsed.password, + decode_responses=True, + ssl=True, + ssl_cert_reqs="none", + ) + logger.info("Created async Redis client with SSL at %s", parsed.hostname) + else: + redis_client = Redis( + host=parsed.hostname or "localhost", + port=parsed.port or 6379, + db=db, + username=parsed.username, # Support Redis 6+ ACLs + password=parsed.password, + decode_responses=True, + ) + logger.info("Created async Redis client at %s", parsed.hostname) + + # Pass pre-configured client to RedisStore + redis_store = RedisStore(client=redis_client) + + # Return raw store if wrapping not requested + if not wrap: + return redis_store + + # Wrap with prefix + if prefix is None: + logger.error("prefix is required when wrap=True") + return None + wrapper_type = store_config.get("WRAPPER_TYPE") if not wrapper_type: logger.error("MCP store WRAPPER_TYPE not configured") return None wrapper_class = _import_wrapper_class(wrapper_type) - redis_store = RedisStore(url=redis_url) store = wrapper_class(key_value=redis_store, prefix=prefix) - logger.info("✅ MCP RedisStore created") + logger.info("Created wrapped MCP RedisStore") return store except Exception as e: logger.error("Failed to create MCP store: %s", e) diff --git a/superset/mcp_service/utils/url_utils.py b/superset/mcp_service/utils/url_utils.py index 44eee2b6fed..55108c7387c 100644 --- a/superset/mcp_service/utils/url_utils.py +++ b/superset/mcp_service/utils/url_utils.py @@ -89,31 +89,3 @@ def get_mcp_service_url() -> str: # Development fallback - direct access to MCP service on port 5008 return "http://localhost:5008" - - -def get_chart_screenshot_url(chart_id: int | str) -> str: - """ - Generate a screenshot URL for a chart using the MCP service. - - Args: - chart_id: Chart ID (numeric or string) - - Returns: - Complete URL to the chart screenshot endpoint - """ - mcp_base = get_mcp_service_url() - return f"{mcp_base}/screenshot/chart/{chart_id}.png" - - -def get_explore_screenshot_url(form_data_key: str) -> str: - """ - Generate a screenshot URL for an explore view using the MCP service. - - Args: - form_data_key: Form data key for the explore view - - Returns: - Complete URL to the explore screenshot endpoint - """ - mcp_base = get_mcp_service_url() - return f"{mcp_base}/screenshot/explore/{form_data_key}.png" diff --git a/superset/models/core.py b/superset/models/core.py index 8fe49119968..2de0a053913 100755 --- a/superset/models/core.py +++ b/superset/models/core.py @@ -197,6 +197,7 @@ class Database(CoreDatabase, AuditMixinNullable, ImportExportMixin): # pylint: "allow_file_upload", "extra", "impersonate_user", + "configuration_method", ] extra_import_fields = [ "password", @@ -896,6 +897,7 @@ class Database(CoreDatabase, AuditMixinNullable, ImportExportMixin): # pylint: ) } except Exception as ex: + self._handle_oauth2_error(ex) raise self.db_engine_spec.get_dbapi_mapped_exception(ex) from ex @cache_util.memoized_func( @@ -930,6 +932,7 @@ class Database(CoreDatabase, AuditMixinNullable, ImportExportMixin): # pylint: ) } except Exception as ex: + self._handle_oauth2_error(ex) raise self.db_engine_spec.get_dbapi_mapped_exception(ex) from ex @cache_util.memoized_func( @@ -966,6 +969,7 @@ class Database(CoreDatabase, AuditMixinNullable, ImportExportMixin): # pylint: ) } except Exception as ex: + self._handle_oauth2_error(ex) raise self.db_engine_spec.get_dbapi_mapped_exception(ex) from ex return set() @@ -994,9 +998,7 @@ class Database(CoreDatabase, AuditMixinNullable, ImportExportMixin): # pylint: with self.get_inspector(catalog=catalog) as inspector: return self.db_engine_spec.get_schema_names(inspector) except Exception as ex: - if self.is_oauth2_enabled() and self.db_engine_spec.needs_oauth2(ex): - self.start_oauth2_dance() - + self._handle_oauth2_error(ex) raise self.db_engine_spec.get_dbapi_mapped_exception(ex) from ex @cache_util.memoized_func( @@ -1013,9 +1015,7 @@ class Database(CoreDatabase, AuditMixinNullable, ImportExportMixin): # pylint: with self.get_inspector() as inspector: return self.db_engine_spec.get_catalog_names(self, inspector) except Exception as ex: - if self.is_oauth2_enabled() and self.db_engine_spec.needs_oauth2(ex): - self.start_oauth2_dance() - + self._handle_oauth2_error(ex) raise self.db_engine_spec.get_dbapi_mapped_exception(ex) from ex @property @@ -1252,6 +1252,10 @@ class Database(CoreDatabase, AuditMixinNullable, ImportExportMixin): # pylint: if oauth2_client_info := encrypted_extra.get("oauth2_client_info"): schema = OAuth2ClientConfigSchema() client_config = schema.load(oauth2_client_info) + if "request_content_type" not in oauth2_client_info: + client_config["request_content_type"] = ( + self.db_engine_spec.oauth2_token_request_type + ) return cast(OAuth2ClientConfig, client_config) return self.db_engine_spec.get_oauth2_config() @@ -1266,6 +1270,16 @@ class Database(CoreDatabase, AuditMixinNullable, ImportExportMixin): # pylint: """ return self.db_engine_spec.start_oauth2_dance(self) + def _handle_oauth2_error(self, ex: Exception) -> None: + """ + Handle exceptions that may require OAuth2 authentication. + + If OAuth2 is enabled and the exception indicates that OAuth2 is needed, + starts the OAuth2 dance. + """ + if self.is_oauth2_enabled() and self.db_engine_spec.needs_oauth2(ex): + self.start_oauth2_dance() + def purge_oauth2_tokens(self) -> None: """ Delete all OAuth2 tokens associated with this database. diff --git a/superset/security/manager.py b/superset/security/manager.py index 1a3532f262d..a619b6ca2dd 100644 --- a/superset/security/manager.py +++ b/superset/security/manager.py @@ -44,7 +44,6 @@ from flask_appbuilder.security.views import ( PermissionViewModelView, ViewMenuModelView, ) -from flask_appbuilder.widgets import ListWidget from flask_babel import lazy_gettext as _ from flask_login import AnonymousUserMixin, LoginManager from jwt.api_jwt import _jwt_global_obj @@ -111,27 +110,6 @@ class DatabaseCatalogSchema(NamedTuple): schema: str -class SupersetSecurityListWidget(ListWidget): # pylint: disable=too-few-public-methods - """ - Redeclaring to avoid circular imports - """ - - template = "superset/fab_overrides/list.html" - - -class SupersetRoleListWidget(ListWidget): # pylint: disable=too-few-public-methods - """ - Role model view from FAB already uses a custom list widget override - So we override the override - """ - - template = "superset/fab_overrides/list_role.html" - - def __init__(self, **kwargs: Any) -> None: - kwargs["appbuilder"] = current_app.appbuilder - super().__init__(**kwargs) - - class SupersetRoleApi(RoleApi): """ Overriding the RoleApi to be able to delete roles with permissions @@ -196,9 +174,6 @@ class SupersetUserApi(UserApi): item.roles = [] -PermissionViewModelView.list_widget = SupersetSecurityListWidget -PermissionModelView.list_widget = SupersetSecurityListWidget - # Limiting routes on FAB model views PermissionViewModelView.include_route_methods = {RouteMethod.LIST} PermissionModelView.include_route_methods = {RouteMethod.LIST} @@ -433,8 +408,9 @@ class SupersetSecurityManager( # pylint: disable=too-many-public-methods ("can_time_range", "Api"), ("can_query_form_data", "Api"), ("can_query", "Api"), - # CSS for dashboard styling + # CSS and themes for dashboard styling ("can_read", "CssTemplate"), + ("can_read", "Theme"), # Embedded dashboard support ("can_read", "EmbeddedDashboard"), # Datasource metadata for chart rendering diff --git a/superset/sql/parse.py b/superset/sql/parse.py index af72f72e952..af9a740ec75 100644 --- a/superset/sql/parse.py +++ b/superset/sql/parse.py @@ -1522,9 +1522,21 @@ def sanitize_clause(clause: str, engine: str) -> str: raise QueryClauseValidationException(f"Invalid SQL clause: {clause}") from ex -def transpile_to_dialect(sql: str, target_engine: str) -> str: +def transpile_to_dialect( + sql: str, + target_engine: str, + source_engine: str | None = None, +) -> str: """ - Transpile SQL from "generic SQL" to the target database dialect using SQLGlot. + Transpile SQL from one database dialect to another using SQLGlot. + + Args: + sql: The SQL query to transpile + target_engine: The target database engine (e.g., "mysql", "postgresql") + source_engine: The source database engine. If None, uses generic SQL dialect. + + Returns: + The transpiled SQL string If the target engine is not in SQLGLOT_DIALECTS, returns the SQL as-is. """ @@ -1534,8 +1546,11 @@ def transpile_to_dialect(sql: str, target_engine: str) -> str: if target_dialect is None: return sql + # Get source dialect (default to generic if not specified) + source_dialect = SQLGLOT_DIALECTS.get(source_engine) if source_engine else Dialect + try: - parsed = sqlglot.parse_one(sql, dialect=Dialect) + parsed = sqlglot.parse_one(sql, dialect=source_dialect) return Dialect.get_or_raise(target_dialect).generate( parsed, copy=True, diff --git a/superset/templates/superset/spa.html b/superset/templates/superset/spa.html index 3597e794707..80e06ae0b32 100644 --- a/superset/templates/superset/spa.html +++ b/superset/templates/superset/spa.html @@ -24,6 +24,8 @@ {% block title %} {% if title %} {{ title }} + {% else %} + {{ default_title | default('Superset') }} {% endif %} {% endblock %} diff --git a/superset/translations/mi/LC_MESSAGES/messages.po b/superset/translations/mi/LC_MESSAGES/messages.po new file mode 100644 index 00000000000..7e13b720674 --- /dev/null +++ b/superset/translations/mi/LC_MESSAGES/messages.po @@ -0,0 +1,14507 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +# Māori translations for Superset. +# Copyright (C) 2025 Superset +# This file is distributed under the same license as the Superset project. +# karo.co.nz, 2025. +msgid "" +msgstr "" +"Project-Id-Version: Superset VERSION\n" +"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" +"POT-Creation-Date: 2025-04-29 12:34+0330\n" +"PO-Revision-Date: 2026-01-25 16:09+1300\n" +"Last-Translator: karo.co.nz\n" +"Language-Team: Māori \n" +"Language: mi\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n != 1)\n" +"Generated-By: Babel 2.9.1\n" + +msgid "" +"\n" +" The cumulative option allows you to see how your data accumulates over different\n" +" values. When enabled, the histogram bars represent the running total of frequencies\n" +" up to each bin. This helps you understand how likely it is to encounter values\n" +" below a certain point. Keep in mind that enabling cumulative doesn't change your\n" +" original data, it just changes the way the histogram is displayed." +msgstr "" +"\n" +" Mā te kōwhiringa whakakōputu ka taea e koe te kite me pēhea te kohikohi o ō\n" +" raraunga i ngā uara rerekē. Ina whakahohekingia, ko ngā pae kauwhata e tohu ana i\n" +" te tapeke rere o ngā auautanga tae noa ki ia pouaka. Ka āwhina tēnei i a koe ki te\n" +" mārama atu he pēhea te tūponotanga kia tūtaki i ngā uara i raro iho i tētahi tūnga.\n" +" Kia mahara, ko te whakahohe i te whakakōputu karekau e whakarereke i ō raraunga\n" +" taketake, he whakarereke noa i te āhua o te whakaaturanga o te kauwhata." + +msgid "" +"\n" +" The normalize option transforms the histogram values into proportions or\n" +" probabilities by dividing each bin's count by the total count of data points.\n" +" This normalization process ensures that the resulting values sum up to 1,\n" +" enabling a relative comparison of the data's distribution and providing a\n" +" clearer understanding of the proportion of data points within each bin." +msgstr "" +"\n" +" Mā te kōwhiringa whakawhānui ka whakawhiua ngā uara kauwhata hei ōwehenga, hei\n" +" tūponotanga rānei mā te wehe i te tatau o ia pouaka ki te tatau katoa o ngā tohu\n" +" raraunga. Mā tēnei tukanga whakawhānui ka rite pai ngā uara ka puta mai kia 1, ka\n" +" taea ai te whakatairite tata o te tohatoha o ngā raraunga me te whakamarama mārama\n" +" ake i te ōwehenga o ngā tohu raraunga i roto i ia pouaka." + +msgid "" +"\n" +" This filter was inherited from the dashboard's context.\n" +" It won't be saved when saving the chart.\n" +" " +msgstr "" +"\n" +" I whakairihia tēnei tātari mai i te horopaki o te papatohu.\n" +" Karekau e tiakina ina tiakina te kauwhata.\n" +" " + +#, python-format +msgid "" +"\n" +"

Your report/alert was unable to be generated because of the following error: %(text)s

\n" +"

Please check your dashboard/chart for errors.

\n" +"

%(call_to_action)s

\n" +" " +msgstr "" +"\n" +"

Kāore i taea te hanga i tō pūrongo/matohi nā tēnei hapa: %(text)s

\n" +"

Tēnā tirohia tō papatohu/kauwhata mō ngā hapa.

\n" +"

%(call_to_action)s

\n" +" " + +msgid " (excluded)" +msgstr " (kua whakakorehia)" + +msgid "" +" Set the opacity to 0 if you do not want to override the color specified in " +"the GeoJSON" +msgstr "" +" Whakatakotohia te mātāwai ki te 0 mēnā karekau koe e hiahia ki te whakakapi" +" i te tae kua tohua i te GeoJSON" + +msgid " a dashboard OR " +msgstr " he papatohu RĀNEI " + +msgid " a new one" +msgstr " he mea hou" + +#, python-format +msgid " at line %(line)d" +msgstr " i te rārangi %(line)d" + +msgid " expression which needs to adhere to the " +msgstr " kīanga e hāngai ana ki te " + +#, python-format +msgid " near '%(highlight)s'" +msgstr " tata ki '%(highlight)s'" + +msgid " source code of Superset's sandboxed parser" +msgstr " waehere puna o te kaiwaewae koheru a Superset" + +msgid "" +" standard to ensure that the lexicographical ordering\n" +" coincides with the chronological ordering. If the\n" +" timestamp format does not adhere to the ISO 8601 standard\n" +" you will need to define an expression and type for\n" +" transforming the string into a date or timestamp. Note\n" +" currently time zones are not supported. If time is stored\n" +" in epoch format, put `epoch_s` or `epoch_ms`. If no pattern\n" +" is specified we fall back to using the optional defaults on a per\n" +" database/column name level via the extra parameter." +msgstr "paerewa hei whakarite kia rite te rārangi kupu" + +msgid " to add calculated columns" +msgstr " hei tāpiri i ngā tīwae tatau" + +msgid " to add metrics" +msgstr " hei tāpiri i ngā ine" + +msgid " to edit or add columns and metrics." +msgstr " hei whakatika, hei tāpiri i ngā tīwae me ngā ine." + +msgid " to mark a column as a time column" +msgstr " hei tohu i tētahi tīwae hei tīwae wā" + +msgid " to open SQL Lab. From there you can save the query as a dataset." +msgstr "" +" hei huaki i te SQL Lab. Mai i reira ka taea e koe te tiaki i te pātai hei " +"rārangi raraunga." + +msgid " to visualize your data." +msgstr " hei whakakite i ō raraunga." + +msgid "!= (Is not equal)" +msgstr "!= (Karekau e ōrite)" + +#, python-format +msgid "% calculation" +msgstr "% tatauranga" + +#, python-format +msgid "% of parent" +msgstr "% o te mātua" + +#, python-format +msgid "% of total" +msgstr "% o te katoa" + +#, python-format +msgid "%(dialect)s cannot be used as a data source for security reasons." +msgstr "" +"Kāore e taea te whakamahi i te %(dialect)s hei puna raraunga mō ngā take " +"haumaru." + +#, python-format +msgid "%(label)s file" +msgstr "kōnae %(label)s" + +#, python-format +msgid "%(name)s.csv" +msgstr "%(name)s.csv" + +#, python-format +msgid "%(name)s.pdf" +msgstr "%(name)s.pdf" + +#, python-format +msgid "%(object)s does not exist in this database." +msgstr "Karekau %(object)s i roto i tēnei pātengi raraunga." + +#, python-format +msgid "%(prefix)s %(title)s" +msgstr "%(prefix)s %(title)s" + +#, python-format +msgid "" +"%(report_type)s schedule frequency exceeding limit. Please configure a " +"schedule with a minimum interval of %(minimum_interval)d minutes per " +"execution." +msgstr "" +"Kei te nui rawa atu te auau o te hōtaka %(report_type)s. Tēnā whirihora he " +"hōtaka me te wā iti rawa o %(minimum_interval)d meneti ia whakatutukitanga." + +#, python-format +msgid "%(rows)d rows returned" +msgstr "%(rows)d rārangi i whakahokia mai" + +#, python-format +msgid "%(suggestion)s instead of \"%(undefinedParameter)s?\"" +msgid_plural "" +"%(firstSuggestions)s or %(lastSuggestion)s instead of " +"\"%(undefinedParameter)s\"?" +msgstr[0] "%(suggestion)s hei utu mō \"%(undefinedParameter)s?\"" +msgstr[1] "" +"%(firstSuggestions)s, %(lastSuggestion)s rānei hei utu mō " +"\"%(undefinedParameter)s\"?" + +#, python-format +msgid "" +"%(validator)s was unable to check your query.\n" +"Please recheck your query.\n" +"Exception: %(ex)s" +msgstr "Kāore i taea e %(validator)s te tirotiro i tō pātai." + +#, python-format +msgid "%s Error" +msgstr "%s Hapa" + +#, python-format +msgid "%s PASSWORD" +msgstr "%s KUPUHIPA" + +#, python-format +msgid "%s SSH TUNNEL PASSWORD" +msgstr "%s SSH TUNNEL KUPUHIPA" + +#, python-format +msgid "%s SSH TUNNEL PRIVATE KEY" +msgstr "%s SSH TUNNEL KĪMATAWHĀ" + +#, python-format +msgid "%s SSH TUNNEL PRIVATE KEY PASSWORD" +msgstr "%s SSH TUNNEL KUPUHIPA KĪMATAWHĀ" + +#, python-format +msgid "%s Selected" +msgstr "%s Kua Tīpakohia" + +#, python-format +msgid "%s Selected (%s Physical, %s Virtual)" +msgstr "%s Kua Tīpakohia (%s Kikokiko, %s Mariko)" + +#, python-format +msgid "%s Selected (Physical)" +msgstr "%s Kua Tīpakohia (Kikokiko)" + +#, python-format +msgid "%s Selected (Virtual)" +msgstr "%s Kua Tīpakohia (Mariko)" + +#, python-format +msgid "%s aggregates(s)" +msgstr "%s whakaarotau" + +#, python-format +msgid "%s column(s)" +msgstr "%s tīwae" + +#, python-format +msgid "" +"%s items could not be tagged because you don’t have edit permissions to all " +"selected objects." +msgstr "" +"Kāore i taea te tohu %s taonga nā te mea kāore ō mōtika whakatika ki ngā mea" +" katoa kua tīpakohia." + +#, python-format +msgid "%s operator(s)" +msgstr "%s kaiwhakahaere" + +#, python-format +msgid "%s option" +msgid_plural "%s options" +msgstr[0] "%s kōwhiringa" +msgstr[1] "%s kōwhiringa" + +#, python-format +msgid "%s option(s)" +msgstr "%s kōwhiringa" + +#, python-format +msgid "%s recipients" +msgstr "%s kaiwhakawhiti" + +#, python-format +msgid "%s row" +msgid_plural "%s rows" +msgstr[0] "%s rārangi" +msgstr[1] "%s rārangi" + +#, python-format +msgid "%s saved metric(s)" +msgstr "%s ine kua tiakina" + +#, python-format +msgid "%s updated" +msgstr "%s kua whakahouhia" + +#, python-format +msgid "%s%s" +msgstr "%s%s" + +#, python-format +msgid "%s-%s of %s" +msgstr "%s-%s o %s" + +msgid "(Removed)" +msgstr "(Kua Tangohia)" + +msgid "(deleted or invalid type)" +msgstr "(kua mukua, he momo muhu rānei)" + +msgid "(no description, click to see stack trace)" +msgstr "(karekau he whakamārama, pāwhiritia kia kite i te aromahue)" + +msgid "), and they become available in your SQL (example:" +msgstr "), ā, ka wātea i roto i tō SQL (tauira:" + +#, python-format +msgid "" +"*%(name)s*\n" +"\n" +" %(description)s\n" +"\n" +" Error: %(text)s\n" +" " +msgstr "*%(name)s*" + +#, python-format +msgid "" +"*%(name)s*\n" +"\n" +"%(description)s\n" +"\n" +"<%(url)s|Explore in Superset>\n" +"\n" +"%(table)s\n" +msgstr "*%(name)s*\n" + +#, python-format +msgid "+ %s more" +msgstr "+ %s atu anō" + +msgid "" +"-- Note: Unless you save your query, these tabs will NOT persist if you clear your cookies or change browsers.\n" +"\n" +msgstr "" +"-- Tuhipoka: Mēnā karekau koe e tiaki i tō pātai, KAREKAU ēnei ripa e mau " +"tonu mēnā ka whakakore koe i ō pihikete, ka huri rawa rānei i ngā " +"pūtirotiro.\n" + +#, python-format +msgid "... and %s others" +msgstr "me %s atu anō" + +msgid "0 Selected" +msgstr "0 Kua Tīpakohia" + +msgid "1 calendar day frequency" +msgstr "1 auau rā maramataka" + +msgid "1 day" +msgstr "1 rā" + +msgid "1 day ago" +msgstr "1 rā i mua" + +msgid "1 hour" +msgstr "1 hāora" + +msgid "1 hourly frequency" +msgstr "1 auau ia hāora" + +msgid "1 minute" +msgstr "1 meneti" + +msgid "1 minutely frequency" +msgstr "1 auau ia meneti" + +msgid "1 month ago" +msgstr "1 marama i mua" + +msgid "1 month end frequency" +msgstr "1 auau mutunga marama" + +msgid "1 month start frequency" +msgstr "1 auau tīmatanga marama" + +msgid "1 week" +msgstr "1 wiki" + +msgid "1 week ago" +msgstr "1 wiki i mua" + +msgid "1 week starting Monday (freq=W-MON)" +msgstr "1 wiki ka tīmata i te Mane (freq=W-MON)" + +msgid "1 week starting Sunday (freq=W-SUN)" +msgstr "1 wiki ka tīmata i te Rātapu (freq=W-SUN)" + +msgid "1 year" +msgstr "1 tau" + +msgid "1 year ago" +msgstr "1 tau i mua" + +msgid "1 year end frequency" +msgstr "1 auau mutunga tau" + +msgid "1 year start frequency" +msgstr "1 auau tīmatanga tau" + +msgid "10 minute" +msgstr "10 meneti" + +msgid "10/90 percentiles" +msgstr "10/90 ōrau ōwehenga" + +msgid "10000" +msgstr "10000" + +msgid "104 weeks" +msgstr "104 wiki" + +msgid "104 weeks ago" +msgstr "104 wiki i mua" + +msgid "15 minute" +msgstr "15 meneti" + +msgid "156 weeks" +msgstr "156 wiki" + +msgid "156 weeks ago" +msgstr "156 wiki i mua" + +msgid "1AS" +msgstr "AS" + +msgid "1D" +msgstr "D" + +msgid "1H" +msgstr "H" + +msgid "1M" +msgstr "M" + +msgid "1T" +msgstr "T" + +msgid "2 years" +msgstr "2 tau" + +msgid "2 years ago" +msgstr "2 tau i mua" + +msgid "2/98 percentiles" +msgstr "2/98 ōrau ōwehenga" + +msgid "22" +msgstr "22" + +msgid "28 days" +msgstr "28 rā" + +msgid "28 days ago" +msgstr "28 rā i mua" + +msgid "2D" +msgstr "D" + +msgid "3 letter code of the country" +msgstr "waehere reta o te whenua" + +msgid "3 years" +msgstr "tau" + +msgid "3 years ago" +msgstr "tau i mua" + +msgid "30 days" +msgstr "rā" + +msgid "30 days ago" +msgstr "rā i mua" + +msgid "30 minute" +msgstr "meneti" + +msgid "30 minutes" +msgstr "meneti" + +msgid "30 second" +msgstr "hēkona" + +msgid "30 seconds" +msgstr "hēkona" + +msgid "3D" +msgstr "D" + +msgid "4 weeks (freq=4W-MON)" +msgstr "wiki (freq=4W-MON)" + +msgid "5 minute" +msgstr "meneti" + +msgid "5 minutes" +msgstr "meneti" + +msgid "5 second" +msgstr "hēkona" + +msgid "5 seconds" +msgstr "hēkona" + +msgid "5/95 percentiles" +msgstr "/95 ōrau ōwehenga" + +msgid "52 weeks" +msgstr "wiki" + +msgid "52 weeks ago" +msgstr "wiki i mua" + +msgid "52 weeks starting Monday (freq=52W-MON)" +msgstr "wiki ka tīmata i te Mane (freq=52W-MON)" + +msgid "6 hour" +msgstr "hāora" + +msgid "60 days" +msgstr "rā" + +msgid "7 calendar day frequency" +msgstr "auau rā maramataka" + +msgid "7 days" +msgstr "rā" + +msgid "7D" +msgstr "D" + +msgid "9/91 percentiles" +msgstr "/91 ōrau ōwehenga" + +msgid "90 days" +msgstr "rā" + +msgid ":" +msgstr ":" + +msgid "< (Smaller than)" +msgstr "< (Iti ake i)" + +msgid "<= (Smaller or equal)" +msgstr "<= (Iti ake, ōrite rānei)" + +msgid "" +msgstr "" + +msgid "" +msgstr "" + +msgid "" +msgstr "" + +msgid "" +msgstr "" + +msgid "" +msgstr "" + +msgid "== (Is equal)" +msgstr "== (He ōrite)" + +msgid "> (Larger than)" +msgstr "> (Rahi ake i)" + +msgid ">= (Larger or equal)" +msgstr ">= (Rahi ake, ōrite rānei)" + +msgid "A Big Number" +msgstr "He Tau Nui" + +msgid "A comma-separated list of schemas that files are allowed to upload to." +msgstr "" +"He rārangi māmā-wehea o ngā hanga e whakāetia ana ngā kōnae ki te tukuake." + +msgid "A database port is required when connecting via SSH Tunnel." +msgstr "" +"E hiahiatia ana he tauranga pātengi raraunga ina hono mā te SSH Tunnel." + +msgid "A database with the same name already exists." +msgstr "Kei te tīari kē tētahi pātengi raraunga me te ingoa ōrite." + +msgid "A date is required when using custom date shift" +msgstr "E hiahiatia ana he rā ina whakamahi i te neke rā ritenga" + +msgid "" +"A dictionary with column names and their data types if you need to change " +"the defaults. Example: {\"user_id\":\"int\"}. Check Python's Pandas library " +"for supported data types." +msgstr "" +"He papakupu me ngā ingoa tīwae me ō rātou momo raraunga mēnā me huri koe i " +"ngā taunoa. Tauira: {\"user_id\":\"int\"}. Tirohia te whare pukapuka Pandas " +"a Python mō ngā momo raraunga e tautokona ana." + +msgid "" +"A full URL pointing to the location of the built plugin (could be hosted on " +"a CDN for example)" +msgstr "" +"He URL katoa e tohu ana ki te wāhi o te mono kua hangaia (ka taea te kawe i " +"runga i tētahi CDN hei tauira)" + +msgid "A handlebars template that is applied to the data" +msgstr "He tauira handlebars ka whakahaeretia ki ngā raraunga" + +msgid "A human-friendly name" +msgstr "He ingoa ngāwari ki te tangata" + +msgid "" +"A list of domain names that can embed this dashboard. Leaving this field " +"empty will allow embedding from any domain." +msgstr "" +"He rārangi ingoa rohe ka taea e tēnei papatohu te tāmau. Mēnā ka waiho kau " +"tēnei āpure ka whakāetia te tāmau mai i tētahi rohe." + +msgid "A list of tags that have been applied to this chart." +msgstr "He rārangi tohu kua whakahaeretia ki tēnei kauwhata." + +msgid "" +"A list of users who can alter the chart. Searchable by name or username." +msgstr "" +"He rārangi kaiwhakamahi ka taea te whakarereke i te kauwhata. Ka taea te " +"rapu mā te ingoa, mā te ingoa kaiwhakamahi rānei." + +msgid "A map of the world, that can indicate values in different countries." +msgstr "He mahere o te ao, ka taea te tohu i ngā uara i ngā whenua rerekē." + +msgid "" +"A map that takes rendering circles with a variable radius at " +"latitude/longitude coordinates" +msgstr "" +"He mahere ka tango i ngā porohita me te pūtoro rerekē i ngā tūtohi " +"latitude/longitude" + +msgid "A metric to use for color" +msgstr "He ine hei whakamahi mō te tae" + +msgid "A new chart and dashboard will be created." +msgstr "Ka hangaia he kauwhata me te papatohu hou." + +msgid "A new chart will be created." +msgstr "Ka hangaia he kauwhata hou." + +msgid "A new dashboard will be created." +msgstr "Ka hangaia he papatohu hou." + +msgid "" +"A polar coordinate chart where the circle is broken into wedges of equal " +"angle, and the value represented by any wedge is illustrated by its area, " +"rather than its radius or sweep angle." +msgstr "" +"He kauwhata tūtohi pona kei reira ka wahia te porohita ki ngā kōika me te " +"koki ōrite, ā, ko te uara e tohua ana e tētahi kōika ka whakaaturia e tōna " +"horahanga, kaua ko tōna pūtoro, ko tōna koki tahae rānei." + +msgid "A readable URL for your dashboard" +msgstr "He URL ka taea te pānui mō tō papatohu" + +msgid "" +"A reference to the [Time] configuration, taking granularity into account" +msgstr "He tohutoro ki te whirihora [Wā], me te aro ki te māeneene" + +#, python-format +msgid "A report named \"%(name)s\" already exists" +msgstr "Kei te tīari kē tētahi pūrongo ko \"%(name)s\" te ingoa" + +msgid "A reusable dataset will be saved with your chart." +msgstr "" +"Ka tiakina tētahi rārangi raraunga ka taea te whakamahi anō me tō kauwhata." + +msgid "" +"A set of parameters that become available in the query using Jinja " +"templating syntax" +msgstr "He huinga tawhā ka wātea i te pātai mā te tikanga tauira Jinja" + +msgid "A timeout occurred while executing the query." +msgstr "I puta he wā-pau i te whakatutukitanga o te pātai." + +msgid "A timeout occurred while generating a csv." +msgstr "I puta he wā-pau i te hangarautanga o tētahi csv." + +msgid "A timeout occurred while generating a dataframe." +msgstr "I puta he wā-pau i te hangarautanga o tētahi dataframe." + +msgid "A timeout occurred while taking a screenshot." +msgstr "I puta he wā-pau i te tangohanga o tētahi hopuataata." + +msgid "A valid color scheme is required" +msgstr "E hiahiatia ana he kaupapa tae whaimana" + +msgid "" +"A waterfall chart is a form of data visualization that helps in understanding\n" +" the cumulative effect of sequentially introduced positive or negative values.\n" +" These intermediate values can either be time based or category based." +msgstr "" +"Ko te kauwhata rere wai he āhua whakaaturanga raraunga ka āwhina i te mārama" + +msgid "APPLY" +msgstr "WHAKAHAERETIA" + +msgid "APR" +msgstr "PAE" + +msgid "AQE" +msgstr "AQE" + +msgid "AUG" +msgstr "HER" + +msgid "Axis title margin" +msgstr "Taiapa taitara tukutuku" + +msgid "Axis title position" +msgstr "Tūnga taitara tukutuku" + +msgid "About" +msgstr "Mō" + +msgid "Access" +msgstr "Urunga" + +msgid "Access token" +msgstr "Tohu urunga" + +msgid "Action" +msgstr "Mahinga" + +msgid "Action Log" +msgstr "Rārangi Mahinga" + +msgid "Actions" +msgstr "Mahinga" + +msgid "Active" +msgstr "Hohe" + +msgid "Actual Values" +msgstr "Uara Tūturu" + +msgid "Actual range for comparison" +msgstr "Korahi tūturu mō te whakatairite" + +msgid "Actual time range" +msgstr "Awhe wā tūturu" + +msgid "Actual value" +msgstr "Uara tūturu" + +msgid "Actual values" +msgstr "Uara tūturu" + +msgid "Adaptive formatting" +msgstr "Hōputu urutau" + +msgid "Add" +msgstr "Tāpiri" + +msgid "Add Alert" +msgstr "Tāpiri Matohi" + +msgid "Add BCC Recipients" +msgstr "Tāpiri Kaiwhakawhiti BCC" + +msgid "Add CC Recipients" +msgstr "Tāpiri Kaiwhakawhiti CC" + +msgid "Add CSS template" +msgstr "Tāpiri tauira CSS" + +msgid "Add Dashboard" +msgstr "Tāpiri Papatohu" + +msgid "Add divider" +msgstr "Tāpiri wāhiwahi" + +msgid "Add filter" +msgstr "Tāpiri tātari" + +msgid "Add Layer" +msgstr "Tāpiri Papa" + +msgid "Add Log" +msgstr "Tāpiri Rārangi" + +msgid "Add Report" +msgstr "Tāpiri Pūrongo" + +msgid "Add Role" +msgstr "Tāpiri Tūranga" + +msgid "Add Rule" +msgstr "Tāpiri Ture" + +msgid "Add Tag" +msgstr "Tāpiri Tohu" + +msgid "Add User" +msgstr "Tāpiri Kaiwhakamahi" + +msgid "Add a Plugin" +msgstr "Tāpiri Mono" + +msgid "Add a dataset" +msgstr "Tāpiri rārangi raraunga" + +msgid "Add a new tab" +msgstr "Tāpiri ripa hou" + +msgid "Add a new tab to create SQL Query" +msgstr "Tāpiri ripa hou hei hanga i te Pātai SQL" + +msgid "Add additional custom parameters" +msgstr "Tāpiri tawhā ritenga atu anō" + +msgid "Add an annotation layer" +msgstr "Tāpiri papa tohu" + +msgid "Add an item" +msgstr "Tāpiri mea" + +msgid "Add and edit filters" +msgstr "Tāpiri me te whakatika i ngā tātari" + +msgid "Add annotation" +msgstr "Tāpiri tohu" + +msgid "Add annotation layer" +msgstr "Tāpiri papa tohu" + +msgid "Add another notification method" +msgstr "Tāpiri tikanga whakamōhio anō" + +msgid "Add calculated columns to dataset in \"Edit datasource\" modal" +msgstr "" +"Tāpiri tīwae tatau ki te rārangi raraunga i te paerewa \"Whakatika puna " +"raraunga\"\"" + +msgid "Add calculated temporal columns to dataset in \"Edit datasource\" modal" +msgstr "" +"Tāpiri tīwae wā tatau ki te rārangi raraunga i te paerewa \"Whakatika puna " +"raraunga\"\"" + +msgid "Add color for positive/negative change" +msgstr "Tāpiri tae mō te panoni pai/kino" + +msgid "Add cross-filter" +msgstr "Tāpiri tātari-whiti" + +msgid "Add custom scoping" +msgstr "Tāpiri korahi ritenga" + +msgid "Add dataset columns here to group the pivot table columns." +msgstr "" +"Tāpiri tīwae rārangi raraunga ki konei hei rōpū i ngā tīwae ripanga " +"hurihuri." + +msgid "Add delivery method" +msgstr "Tāpiri tikanga tuku" + +msgid "Add description of your tag" +msgstr "Tāpiri whakamārama mō tō tohu" + +msgid "Add extra connection information." +msgstr "Tāpiri mōhiohio hononga taapiri." + +msgid "" +"Add filter clauses to control the filter's source query,\n" +" though only in the context of the autocomplete i.e., these conditions\n" +" do not impact how the filter is applied to the dashboard. This is useful\n" +" when you want to improve the query's performance by only scanning a subset\n" +" of the underlying data or limit the available values displayed in the filter." +msgstr "" +"Tāpiri rerenga tātari hei whakahaere i te pātai puna o te tātari,\n" +" engari i roto anake i te horopaki o te whakaoti aunoa arā, karekau ēnei āhuatanga\n" +" e pā ana ki te whakamahi o te tātari ki te papatohu. He whaihua tēnei\n" +" ina hiahia koe ki te whakapai ake i te whakatutukitanga o te pātai mā te hōpara noa i tētahi hautanga\n" +" o ngā raraunga e takoto ana, hei whakawhāiti rānei i ngā uara wātea e whakaaturia ana i te tātari." + +msgid "Add item" +msgstr "Tāpiri mea" + +msgid "Add metric" +msgstr "Tāpiri ine" + +msgid "Add metrics to dataset in \"Edit datasource\" modal" +msgstr "" +"Tāpiri ine ki te rārangi raraunga i te paerewa \"Whakatika puna raraunga\"\"" + +msgid "Add new color formatter" +msgstr "Tāpiri kaihōputu tae hou" + +msgid "Add new formatter" +msgstr "Tāpiri kaihōputu hou" + +msgid "Add or edit filters" +msgstr "Tāpiri, whakatika rānei i ngā tātari" + +msgid "Add required control values to preview chart" +msgstr "Tāpiri uara whakahaere e hiahiatia ana hei arokite i te kauwhata" + +msgid "Add required control values to save chart" +msgstr "Tāpiri uara whakahaere e hiahiatia ana hei tiaki i te kauwhata" + +msgid "Add sheet" +msgstr "Tāpiri hīti" + +msgid "Add tag to entities" +msgstr "Tāpiri tohu ki ngā pūtahi" + +msgid "Add the name of the chart" +msgstr "Tāpiri te ingoa o te kauwhata" + +msgid "Add the name of the dashboard" +msgstr "Tāpiri te ingoa o te papatohu" + +msgid "Add to dashboard" +msgstr "Tāpiri ki te papatohu" + +msgid "Added" +msgstr "Kua Tāpiritia" + +#, python-format +msgid "Added 1 new column to the virtual dataset" +msgid_plural "Added %s new columns to the virtual dataset" +msgstr[0] "Kua tāpiritia 1 tīwae hou ki te rārangi raraunga mariko" +msgstr[1] "Kua tāpiritia %s tīwae hou ki te rārangi raraunga mariko" + +#, python-format +msgid "Added to 1 dashboard" +msgid_plural "Added to %s dashboards" +msgstr[0] "Kua tāpiritia ki 1 papatohu" +msgstr[1] "Kua tāpiritia ki %s papatohu" + +msgid "Additional Parameters" +msgstr "Tawhā Taapiri" + +msgid "Additional fields may be required" +msgstr "Ka hiahiatia pea ētahi atu āpure" + +msgid "Additional information" +msgstr "Mōhiohio taapiri" + +msgid "Additional padding for legend." +msgstr "Pākeke taapiri mō te kōrero." + +msgid "Additional parameters" +msgstr "Tawhā taapiri" + +msgid "Additional settings." +msgstr "Tautuhinga taapiri." + +msgid "Additional text to add before or after the value, e.g. unit" +msgstr "" +"Kupu taapiri hei tāpiri i mua, i muri rānei i te uara, hei tauira te waeine" + +msgid "Additive" +msgstr "Tāpiri" + +msgid "" +"Adds color to the chart symbols based on the positive or negative change " +"from the comparison value." +msgstr "" +"Ka tāpiri tae ki ngā tohu kauwhata i runga i te panoni pai, kino rānei mai i" +" te uara whakatairite." + +msgid "" +"Adjust column settings such as specifying the columns to read, how " +"duplicates are handled, column data types, and more." +msgstr "" +"Whakatikatika i ngā tautuhinga tīwae pērā i te tohu i ngā tīwae hei pānui, " +"me pēhea te whakahaere i ngā tārua, ngā momo raraunga tīwae, me ētahi atu." + +msgid "" +"Adjust how spaces, blank lines, null values are handled and other file wide " +"settings." +msgstr "" +"Whakatikatika i te whakahaere o ngā mokowā, ngā rārangi kau, ngā uara kore " +"me ētahi atu tautuhinga whānui kōnae." + +msgid "Adjust how this database will interact with SQL Lab." +msgstr "" +"Whakatikatika me pēhea te taunekeneke o tēnei pātengi raraunga ki SQL Lab." + +msgid "Adjust performance settings of this database." +msgstr "" +"Whakatikatika i ngā tautuhinga whakatutukitanga o tēnei pātengi raraunga." + +msgid "Advanced" +msgstr "Aromatawai" + +msgid "Advanced Analytics" +msgstr "Tātaritanga Aromatawai" + +msgid "Advanced Data type" +msgstr "Momo raraunga Aromatawai" + +msgid "Advanced analytics" +msgstr "Tātaritanga aromatawai" + +msgid "Advanced analytics Query A" +msgstr "Tātaritanga aromatawai Pātai A" + +msgid "Advanced analytics Query B" +msgstr "Tātaritanga aromatawai Pātai B" + +msgid "Advanced analytics post processing" +msgstr "Tukatuka-iho tātaritanga aromatawai" + +msgid "Advanced data type" +msgstr "Momo raraunga aromatawai" + +msgid "Advanced-Analytics" +msgstr "Tātaritanga-Aromatawai" + +msgid "Affected Charts" +msgstr "Kauwhata Pānga" + +msgid "Affected Dashboards" +msgstr "Papatohu Pānga" + +msgid "After" +msgstr "I muri" + +msgid "Aggregate" +msgstr "Whakaarotau" + +msgid "Aggregate Mean" +msgstr "Toharite Whakaarotau" + +msgid "Aggregate Sum" +msgstr "Tapeke Whakaarotau" + +msgid "" +"Aggregate function applied to the list of points in each cluster to produce " +"the cluster label." +msgstr "" +"Taumahi whakaarotau ka whakahaeretia ki te rārangi tohu i ia rāpaki hei " +"whakaputa i te tapanga rāpaki." + +msgid "" +"Aggregate function to apply when pivoting and computing the total rows and " +"columns" +msgstr "" +"Taumahi whakaarotau hei whakahaeretia ina hurihuri ana, ina tatau ana i ngā " +"rārangi me ngā tīwae tapeke" + +msgid "" +"Aggregates data within the boundary of grid cells and maps the aggregated " +"values to a dynamic color scale" +msgstr "" +"Ka whakaarotau i ngā raraunga i roto i te rohe o ngā pūtau tukutata, ā, ka " +"whakamahere i ngā uara kua whakaarotauhia ki tētahi tauine tae autōkē" + +msgid "Aggregation" +msgstr "Whakaarotautanga" + +msgid "Aggregation Method" +msgstr "Tikanga Whakaarotau" + +msgid "Aggregation function" +msgstr "Taumahi whakaarotau" + +msgid "Alert" +msgstr "Matohi" + +msgid "Alert Triggered, In Grace Period" +msgstr "Matohi Kua Whakaohongia, I roto i te Wā Aroha" + +msgid "Alert condition" +msgstr "Āhuatanga matohi" + +msgid "Alert contents" +msgstr "Ihirangi matohi" + +msgid "Alert ended grace period." +msgstr "Matohi kua mutu te wā aroha." + +msgid "Alert failed" +msgstr "I rahua te matohi" + +msgid "Alert fired during grace period." +msgstr "Matohi i pāhia i te wā aroha." + +msgid "Alert found an error while executing a query." +msgstr "I kitea e te Matohi he hapa i te whakatutukitanga o tētahi pātai." + +msgid "Alert is active" +msgstr "Kei te hohe te matohi" + +msgid "Alert name" +msgstr "Ingoa matohi" + +msgid "Alert on grace period" +msgstr "Matohi i runga i te wā aroha" + +msgid "Alert query returned a non-number value." +msgstr "I whakahoki te pātai matohi i tētahi uara ehara i te tau." + +msgid "Alert query returned more than one column." +msgstr "I whakahoki te pātai matohi i te nui atu i te kotahi tīwae." + +#, python-format +msgid "" +"Alert query returned more than one column. %(num_cols)s columns returned" +msgstr "" +"I whakahoki te pātai matohi i te nui atu i te kotahi tīwae. %(num_cols)s " +"tīwae i whakahokia mai" + +msgid "Alert query returned more than one row." +msgstr "I whakahoki te pātai matohi i te nui atu i te kotahi rārangi." + +#, python-format +msgid "Alert query returned more than one row. %(num_rows)s rows returned" +msgstr "" +"I whakahoki te pātai matohi i te nui ake i te kotahi rārangi. %(num_rows)s " +"rārangi i whakahokia mai\"\"" + +msgid "Alert running" +msgstr "Matohi e rere ana" + +msgid "Alert triggered, notification sent" +msgstr "Matohi kua whakaoho, kua tukuna te whakamōhio" + +msgid "Alert validator config error." +msgstr "Hapa whirihora matohi kaimanatoko." + +msgid "Alerts" +msgstr "Matohi" + +msgid "Alerts & Reports" +msgstr "Matohi me ngā Pūrongo" + +msgid "Alerts & reports" +msgstr "Matohi me ngā pūrongo" + +msgid "Align +/-" +msgstr "Whakarite +/-" + +msgid "All" +msgstr "Katoa" + +#, python-format +msgid "All %s hidden columns" +msgstr "Katoa %s tīwae huna" + +msgid "All Text" +msgstr "Tuhinga Katoa" + +msgid "All charts" +msgstr "Kauwhata katoa" + +msgid "All charts/global scoping" +msgstr "Kauwhata katoa/korahi ao whānui" + +msgid "All filters" +msgstr "Tātari katoa" + +msgid "All panels" +msgstr "Papa katoa" + +msgid "Allow CREATE TABLE AS" +msgstr "Whakāetia CREATE TABLE AS" + +msgid "Allow CREATE VIEW AS" +msgstr "Whakāetia CREATE VIEW AS" + +msgid "Allow DDL and DML" +msgstr "Whakāetia DDL me DML" + +msgid "Allow changing catalogs" +msgstr "Whakāetia te huri i ngā kātaloka" + +msgid "" +"Allow column names to be changed to case insensitive format, if supported " +"(e.g. Oracle, Snowflake)." +msgstr "" +"Whakāetia te huri i ngā ingoa tīwae ki te hōputu kore aro reta iti/nui, mēnā" +" e tautokona ana(hei tauira Oracle, Snowflake)." + +msgid "Allow columns to be rearranged" +msgstr "Whakāetia te whakahurihuri i ngā tīwae" + +msgid "Allow creation of new tables based on queries" +msgstr "Whakāetia te hanganga o ngā ripanga hou mai i ngā pātai" + +msgid "Allow creation of new values" +msgstr "Whakāetia te hanganga o ngā uara hou" + +msgid "Allow creation of new views based on queries" +msgstr "Whakāetia te hanganga o ngā tirohanga hou mai i ngā pātai" + +msgid "Allow data manipulation language" +msgstr "Whakāetia te reo whakahaere raraunga" + +msgid "" +"Allow end user to drag-and-drop column headers to rearrange them. Note their" +" changes won't persist for the next time they open the chart." +msgstr "" +"Whakāetia te kaiwhakamahi whakamutunga ki te tō-me-tuku i ngā pane tīwae kia" +" whakahurihuri. Kia mōhio karekau ō rātou huringa e mau tonu mō te wā kē atu" +" ka huaki ai i te kauwhata." + +msgid "Allow file uploads to database" +msgstr "Whakāetia te tukuake kōnae ki te pātengi raraunga" + +msgid "Allow node selections" +msgstr "Whakāetia ngā tīpakonga pona" + +msgid "Allow sending multiple polygons as a filter event" +msgstr "Whakāetia te tuku i ngā tapawhā maha hei kaupapa tātari" + +msgid "" +"Allow the execution of DDL (Data Definition Language: CREATE, DROP, " +"TRUNCATE, etc.) and DML (Data Modification Language: INSERT, UPDATE, DELETE," +" etc)" +msgstr "" +"Whakāetia te whakatutukitanga o te DDL (Reo Tautuhinga Raraunga: CREATE, " +"DROP, TRUNCATE, me ērā atu) me te DML (Reo Whakarereke Raraunga: INSERT, " +"UPDATE, DELETE, me ērā atu)" + +msgid "Allow this database to be explored" +msgstr "Whakāetia tēnei pātengi raraunga kia tūhurahia" + +msgid "Allow this database to be queried in SQL Lab" +msgstr "Whakāetia tēnei pātengi raraunga kia pātaihia i SQL Lab" + +msgid "Allowed Domains (comma separated)" +msgstr "Rohe Whakāetia (māmā wehea)" + +msgid "Alphabetical" +msgstr "Arapū" + +msgid "" +"Also known as a box and whisker plot, this visualization compares the " +"distributions of a related metric across multiple groups. The box in the " +"middle emphasizes the mean, median, and inner 2 quartiles. The whiskers " +"around each box visualize the min, max, range, and outer 2 quartiles." +msgstr "" +"E mōhiotia ana hei kauwhata pouaka me te whīhau, ka whakatairite tēnei " +"whakakitenga i ngā tohatoha o tētahi ine hāngai puta noa i ngā rōpū maha. Ko" +" te pouaka i waenga nei e whakanui ana i te toharite, te pū, me ngā " +"hautakiwā 2 o roto. Ko ngā whīhau i ia taha o ia pouaka ka whakakite i te " +"iti, te rahi, te korahi, me ngā hautakiwā 2 o waho." + +msgid "Altered" +msgstr "Kua Whakarereke" + +msgid "Always filter main datetime column" +msgstr "Tātari i te tīwae wā matua i ngā wā katoa" + +msgid "An Error Occurred" +msgstr "I Puta He Hapa" + +#, python-format +msgid "An alert named \"%(name)s\" already exists" +msgstr "Kei te tīari kē tētahi matohi ko \"%(name)s\" te ingoa\"" + +msgid "" +"An enclosed time range (both start and end) must be specified when using a " +"Time Comparison." +msgstr "" +"Me tohua tētahi awhe wā kōporo (te tīmatanga me te mutunga) ina whakamahia " +"te Whakatairite Wā." + +msgid "" +"An engine must be specified when passing individual parameters to a " +"database." +msgstr "" +"Me tohua he pūkaha ina tukuna ngā tawhā takitahi ki tētahi pātengi raraunga." + +msgid "An error has occurred" +msgstr "Kua puta he hapa" + +msgid "An error has occurred while syncing virtual dataset columns" +msgstr "I puta he hapa i te hāngaitanga o ngā tīwae rārangi raraunga mariko" + +msgid "An error occurred" +msgstr "I puta he hapa" + +msgid "An error occurred saving dataset" +msgstr "I puta he hapa i te tiakitanga o te rārangi raraunga" + +msgid "An error occurred when running alert query" +msgstr "I puta he hapa i te whakatutukitanga o te pātai matohi" + +msgid "An error occurred while accessing the copy link." +msgstr "I puta he hapa i te urunga ki te hono tārua." + +msgid "An error occurred while accessing the value." +msgstr "I puta he hapa i te urunga ki te uara." + +msgid "" +"An error occurred while collapsing the table schema. Please contact your " +"administrator." +msgstr "" +"I puta he hapa i te hīngonga o te hanga pātengi raraunga. Tēnā whakapā atu " +"ki tō kaiwhakahaere." + +#, python-format +msgid "An error occurred while creating %ss: %s" +msgstr "I puta he hapa i te hanganga o %ss: %s" + +msgid "An error occurred while creating the copy link." +msgstr "I puta he hapa i te hanganga o te hono tārua." + +msgid "An error occurred while creating the data source" +msgstr "I puta he hapa i te hanganga o te puna raraunga" + +msgid "An error occurred while creating the value." +msgstr "I puta he hapa i te hanganga o te uara." + +msgid "An error occurred while deleting the value." +msgstr "I puta he hapa i te mukutanga o te uara." + +msgid "" +"An error occurred while expanding the table schema. Please contact your " +"administrator." +msgstr "" +"I puta he hapa i te whakawhānuitanga o te hanga ripanga. Tēnā whakapā atu ki" +" tō kaiwhakahaere." + +#, python-format +msgid "An error occurred while fetching %s info: %s" +msgstr "I puta he hapa i te tikitanga o ngā mōhiohio %s: %s" + +#, python-format +msgid "An error occurred while fetching %ss: %s" +msgstr "I puta he hapa i te tikitanga o %ss: %s" + +msgid "An error occurred while fetching available CSS templates" +msgstr "I puta he hapa i te tikitanga o ngā tauira CSS wātea" + +#, python-format +msgid "An error occurred while fetching chart owners values: %s" +msgstr "I puta he hapa i te tikitanga o ngā uara rangatira kauwhata: %s" + +#, python-format +msgid "An error occurred while fetching dashboard owner values: %s" +msgstr "I puta he hapa i te tikitanga o ngā uara rangatira papatohu: %s" + +msgid "An error occurred while fetching dashboards" +msgstr "I puta he hapa i te tikitanga o ngā papatohu" + +#, python-format +msgid "An error occurred while fetching dashboards: %s" +msgstr "I puta he hapa i te tikitanga o ngā papatohu: %s" + +#, python-format +msgid "An error occurred while fetching database related data: %s" +msgstr "" +"I puta he hapa i te tikitanga o ngā raraunga hāngai pātengi raraunga: %s" + +#, python-format +msgid "An error occurred while fetching database values: %s" +msgstr "I puta he hapa i te tikitanga o ngā uara pātengi raraunga: %s" + +#, python-format +msgid "An error occurred while fetching dataset datasource values: %s" +msgstr "" +"I puta he hapa i te tikitanga o ngā uara puna raraunga rārangi raraunga: %s" + +#, python-format +msgid "An error occurred while fetching dataset owner values: %s" +msgstr "" +"I puta he hapa i te tikitanga o ngā uara rangatira rārangi raraunga: %s" + +msgid "An error occurred while fetching dataset related data" +msgstr "I puta he hapa i te tikitanga o ngā raraunga hāngai rārangi raraunga" + +#, python-format +msgid "An error occurred while fetching dataset related data: %s" +msgstr "" +"I puta he hapa i te tikitanga o ngā raraunga hāngai rārangi raraunga: %s" + +#, python-format +msgid "An error occurred while fetching datasets: %s" +msgstr "I puta he hapa i te tikitanga o ngā rārangi raraunga: %s" + +msgid "An error occurred while fetching function names." +msgstr "I puta he hapa i te tikitanga o ngā ingoa taumahi." + +#, python-format +msgid "An error occurred while fetching owners values: %s" +msgstr "I puta he hapa i te tikitanga o ngā uara rangatira: %s" + +#, python-format +msgid "An error occurred while fetching schema values: %s" +msgstr "I puta he hapa i te tikitanga o ngā uara hanga: %s" + +msgid "An error occurred while fetching tab state" +msgstr "I puta he hapa i te tikitanga o te tūnga ripa" + +msgid "An error occurred while fetching table metadata" +msgstr "I puta he hapa i te tikitanga o te metadata ripanga" + +msgid "" +"An error occurred while fetching table metadata. Please contact your " +"administrator." +msgstr "" +"I puta he hapa i te tikitanga o te metadata ripanga. Tēnā whakapā atu ki tō " +"kaiwhakahaere." + +#, python-format +msgid "An error occurred while fetching user values: %s" +msgstr "I puta he hapa i te tikitanga o ngā uara kaiwhakamahi: %s" + +#, python-format +msgid "An error occurred while importing %s: %s" +msgstr "I puta he hapa i te kawemaitanga o %s: %s" + +msgid "An error occurred while loading dashboard information." +msgstr "I puta he hapa i te utanga o ngā mōhiohio papatohu." + +msgid "An error occurred while loading the SQL" +msgstr "I puta he hapa i te utanga o te SQL" + +msgid "An error occurred while opening Explore" +msgstr "I puta he hapa i te huakitanga o te Tūhura" + +msgid "An error occurred while parsing the key." +msgstr "I puta he hapa i te poroporo o te kī." + +msgid "An error occurred while pruning logs " +msgstr "I puta he hapa i te puretanga o ngā rārangi " + +msgid "" +"An error occurred while removing query. Please contact your administrator." +msgstr "" +"I puta he hapa i te tangotanga o te pātai. Tēnā whakapā atu ki tō " +"kaiwhakahaere." + +msgid "" +"An error occurred while removing the table schema. Please contact your " +"administrator." +msgstr "" +"I puta he hapa i te tangotanga o te hanga ripanga. Tēnā whakapā atu ki tō " +"kaiwhakahaere." + +#, python-format +msgid "An error occurred while rendering the visualization: %s" +msgstr "I puta he hapa i te whakaatutanga o te whakakitenga: %s" + +msgid "An error occurred while starring this chart" +msgstr "I puta he hapa i te whakawhetu i tēnei kauwhata" + +msgid "" +"An error occurred while storing your query in the backend. To avoid losing " +"your changes, please save your query using the \"Save Query\" button." +msgstr "" +"I puta he hapa i te penapena o tō pātai i te tuarongo. Hei karo i te ngaro o" +" ō huringa, tēnā tiakihia tō pātai mā te pātene \"Tiaki Pātai\"." + +#, python-format +msgid "An error occurred while syncing permissions for %s: %s" +msgstr "I puta he hapa i te hāngaitanga o ngā mōtika mō %s: %s" + +msgid "An error occurred while updating the value." +msgstr "I puta he hapa i te whakahouhanga o te uara." + +msgid "An error occurred while upserting the value." +msgstr "I puta he hapa i te whakahoutanga o te uara." + +msgid "An unexpected error occurred" +msgstr "I puta he hapa ohorere" + +msgid "Anchor to" +msgstr "Punga ki" + +msgid "Angle at which to end progress axis" +msgstr "Koki hei mutu i te tukutuku kokenga" + +msgid "Angle at which to start progress axis" +msgstr "Koki hei tīmata i te tukutuku kokenga" + +msgid "Animation" +msgstr "Whakahihiko" + +msgid "Annotation" +msgstr "Tohu" + +#, python-format +msgid "Annotation Layer %s" +msgstr "Papa Tohu %s" + +msgid "Annotation Layers" +msgstr "Papa Tohu" + +msgid "Annotation Slice Configuration" +msgstr "Whirihora Kauwhata Tohu" + +msgid "Annotation could not be created." +msgstr "Kāore i taea te hanga i te tohu." + +msgid "Annotation could not be updated." +msgstr "Kāore i taea te whakahou i te tohu." + +msgid "Annotation layer" +msgstr "Papa tohu" + +msgid "Annotation layer could not be created." +msgstr "Kāore i taea te hanga i te papa tohu." + +msgid "Annotation layer could not be updated." +msgstr "Kāore i taea te whakahou i te papa tohu." + +msgid "Annotation layer description columns" +msgstr "Tīwae whakamārama papa tohu" + +msgid "Annotation layer has associated annotations." +msgstr "He tohu tūhono tō te papa tohu." + +msgid "Annotation layer interval end" +msgstr "Mutunga wā papa tohu" + +msgid "Annotation layer name" +msgstr "Ingoa papa tohu" + +msgid "Annotation layer not found." +msgstr "Kāore i kitea te papa tohu." + +msgid "Annotation layer opacity" +msgstr "Mātāwai papa tohu" + +msgid "Annotation layer parameters are invalid." +msgstr "He muhu ngā tawhā papa tohu." + +msgid "Annotation layer stroke" +msgstr "Whakapā papa tohu" + +msgid "Annotation layer time column" +msgstr "Tīwae wā papa tohu" + +msgid "Annotation layer title column" +msgstr "Tīwae taitara papa tohu" + +msgid "Annotation layer type" +msgstr "Momo papa tohu" + +msgid "Annotation layer value" +msgstr "Uara papa tohu" + +msgid "Annotation layers" +msgstr "Papa tohu" + +msgid "Annotation layers are still loading." +msgstr "Kei te uta tonu ngā papa tohu." + +msgid "Annotation layers could not be deleted." +msgstr "Kāore i taea te muku i ngā papa tohu." + +msgid "Annotation not found." +msgstr "Kāore i kitea te tohu." + +msgid "Annotation parameters are invalid." +msgstr "He muhu ngā tawhā tohu." + +msgid "Annotation source" +msgstr "Puna tohu" + +msgid "Annotation source type" +msgstr "Momo puna tohu" + +msgid "Annotation template created" +msgstr "Kua hangaia te tauira tohu" + +msgid "Annotation template updated" +msgstr "Kua whakahouhia te tauira tohu" + +msgid "Annotations and Layers" +msgstr "Tohu me ngā Papa" + +msgid "Annotations and layers" +msgstr "Tohu me ngā papa" + +msgid "Annotations could not be deleted." +msgstr "Kāore i taea te muku i ngā tohu." + +msgid "Any" +msgstr "Tētahi" + +msgid "Any additional detail to show in the certification tooltip." +msgstr "He taipitopito taapiri hei whakaatu i te kītukutuku tohu tautūtanga." + +msgid "" +"Any color palette selected here will override the colors applied to this " +"dashboard's individual charts" +msgstr "" +"Ka whakakapi tētahi paka tae e tīpakohia ana ki konei i ngā tae kua " +"whakahaeretia ki ngā kauwhata takitahi o tēnei papatohu" + +msgid "" +"Any databases that allow connections via SQL Alchemy URIs can be added. " +msgstr "" +"Ka taea te tāpiri i ngā pātengi raraunga katoa e whakāe ana i ngā hononga mā" +" ngā URI SQL Alchemy. " + +msgid "" +"Any databases that allow connections via SQL Alchemy URIs can be added. " +"Learn about how to connect a database driver " +msgstr "" +"Ka taea te tāpiri i ngā pātengi raraunga katoa e whakāe ana i ngā hononga mā" +" ngā URI SQL Alchemy. Akona me pēhea te hono i tētahi taraiwa pātengi " +"raraunga " + +#, python-format +msgid "Applied cross-filters (%d)" +msgstr "Tātari-whiti kua whakahaeretia (%d)" + +#, python-format +msgid "Applied filters (%d)" +msgstr "Tātari kua whakahaeretia (%d)" + +#, python-format +msgid "Applied filters (%s)" +msgstr "Tātari kua whakahaeretia (%s)" + +#, python-format +msgid "Applied filters: %s" +msgstr "Tātari kua whakahaeretia: %s" + +msgid "" +"Applied rolling window did not return any data. Please make sure the source " +"query satisfies the minimum periods defined in the rolling window." +msgstr "" +"Kāore i whakahoki raraunga te matapihi takahuri i whakahaeretia. Tēnā kia " +"mārama ka ea i te pātai puna ngā wā iti kua tohua i te matapihi takahuri." + +msgid "Apply" +msgstr "Whakahaeretia" + +msgid "Apply conditional color formatting to metric" +msgstr "Whakahaeretia te hōputu tae āhuatanga ki te ine" + +msgid "Apply conditional color formatting to metrics" +msgstr "Whakahaeretia te hōputu tae āhuatanga ki ngā ine" + +msgid "Apply conditional color formatting to numeric columns" +msgstr "Whakahaeretia te hōputu tae āhuatanga ki ngā tīwae tau" + +msgid "Apply filters" +msgstr "Whakahaeretia ngā tātari" + +msgid "Apply metrics on" +msgstr "Whakahaeretia ngā ine ki" + +msgid "April" +msgstr "Paenga-whāwhā" + +msgid "Arc" +msgstr "Kopeka" + +msgid "Are you sure you intend to overwrite the following values?" +msgstr "Kei te tino hiahia koe ki te tuhirua i ngā uara e whai ake nei?" + +msgid "Are you sure you want to cancel?" +msgstr "Kei te tino hiahia koe ki te whakakore?" + +msgid "Are you sure you want to delete" +msgstr "Kei te tino hiahia koe ki te muku" + +#, python-format +msgid "Are you sure you want to delete %s?" +msgstr "Kei te tino hiahia koe ki te muku i %s?" + +#, python-format +msgid "Are you sure you want to delete the selected %s?" +msgstr "Kei te tino hiahia koe ki te muku i %s kua tīpakohia?" + +msgid "Are you sure you want to delete the selected annotations?" +msgstr "Kei te tino hiahia koe ki te muku i ngā tohu kua tīpakohia?" + +msgid "Are you sure you want to delete the selected charts?" +msgstr "Kei te tino hiahia koe ki te muku i ngā kauwhata kua tīpakohia?" + +msgid "Are you sure you want to delete the selected dashboards?" +msgstr "Kei te tino hiahia koe ki te muku i ngā papatohu kua tīpakohia?" + +msgid "Are you sure you want to delete the selected datasets?" +msgstr "" +"Kei te tino hiahia koe ki te muku i ngā rārangi raraunga kua tīpakohia?" + +msgid "Are you sure you want to delete the selected layers?" +msgstr "Kei te tino hiahia koe ki te muku i ngā papa kua tīpakohia?" + +msgid "Are you sure you want to delete the selected queries?" +msgstr "Kei te tino hiahia koe ki te muku i ngā pātai kua tīpakohia?" + +msgid "Are you sure you want to delete the selected roles?" +msgstr "Kei te tino hiahia koe ki te muku i ngā tūranga kua tīpakohia?" + +msgid "Are you sure you want to delete the selected rules?" +msgstr "Kei te tino hiahia koe ki te muku i ngā ture kua tīpakohia?" + +msgid "Are you sure you want to delete the selected tags?" +msgstr "Kei te tino hiahia koe ki te muku i ngā tohu kua tīpakohia?" + +msgid "Are you sure you want to delete the selected templates?" +msgstr "Kei te tino hiahia koe ki te muku i ngā tauira kua tīpakohia?" + +msgid "Are you sure you want to delete the selected users?" +msgstr "Kei te tino hiahia koe ki te muku i ngā kaiwhakamahi kua tīpakohia?" + +msgid "Are you sure you want to overwrite this dataset?" +msgstr "Kei te tino hiahia koe ki te tuhirua i tēnei rārangi raraunga?" + +msgid "Are you sure you want to proceed?" +msgstr "Kei te tino hiahia koe ki te haere tonu?" + +msgid "Are you sure you want to save and apply changes?" +msgstr "Kei te tino hiahia koe ki te tiaki me te whakahaeretia ngā huringa?" + +msgid "Area" +msgstr "Horahanga" + +msgid "Area Chart" +msgstr "Kauwhata Horahanga" + +msgid "Area chart" +msgstr "Kauwhata horahanga" + +msgid "Area chart opacity" +msgstr "Mātāwai kauwhata horahanga" + +msgid "" +"Area charts are similar to line charts in that they represent variables with" +" the same scale, but area charts stack the metrics on top of each other." +msgstr "" +"He ōrite ngā kauwhata horahanga ki ngā kauwhata rārangi i te tohu i ngā " +"taurangi me te tauine ōrite, engari ka whakapaparanga ngā kauwhata " +"horahanga i ngā ine i runga i tētahi i tētahi." + +msgid "Arrow" +msgstr "Pere" + +msgid "Assign a set of parameters as" +msgstr "Tūtohua tētahi huinga tawhā hei" + +msgid "Assist" +msgstr "Āwhina" + +msgid "Asynchronous query execution" +msgstr "Whakatutukitanga pātai kore-hangarite" + +msgid "Attribution" +msgstr "Whakatuakī" + +msgid "August" +msgstr "Hereturikōkā" + +msgid "Authorization needed" +msgstr "E hiahiatia ana te whakamana" + +msgid "Auto" +msgstr "Aunoa" + +msgid "Auto Zoom" +msgstr "Topa Aunoa" + +msgid "Autocomplete" +msgstr "Whakaoti Aunoa" + +msgid "Autocomplete filters" +msgstr "Tātari whakaoti aunoa" + +msgid "Autocomplete query predicate" +msgstr "Kīanga tohu pātai whakaoti aunoa" + +msgid "Automatic color" +msgstr "Tae aunoa" + +msgid "Autosize Column" +msgstr "Tauine Aunoa Tīwae" + +msgid "Autosize all columns" +msgstr "Tauine aunoa i ngā tīwae katoa" + +msgid "Available Handlebars Helpers in Superset:" +msgstr "Kaiarotau Handlebars Wātea i Superset:" + +msgid "Available sorting modes:" +msgstr "Āhuatanga kōmaka wātea:" + +msgid "Average" +msgstr "Toharite" + +msgid "Average (Mean)" +msgstr "Toharite (Pū)" + +msgid "Average value" +msgstr "Uara toharite" + +msgid "Axis" +msgstr "Tukutuku" + +msgid "Axis Bounds" +msgstr "Rohe Tukutuku" + +msgid "Axis Format" +msgstr "Hōputu Tukutuku" + +msgid "Axis Title" +msgstr "Taitara Tukutuku" + +msgid "Axis ascending" +msgstr "Tukutuku piki" + +msgid "Axis descending" +msgstr "Tukutuku heke" + +msgid "BCC recipients" +msgstr "Kaiwhakawhiti BCC" + +msgid "BOOLEAN" +msgstr "PŪRUHI" + +msgid "Back" +msgstr "Hoki" + +msgid "Back to all" +msgstr "Hoki ki te katoa" + +msgid "Backend" +msgstr "Tuarongo" + +msgid "Background Color" +msgstr "Tae Papamuri" + +msgid "Backward values" +msgstr "Uara whakamuri" + +msgid "Bad formula." +msgstr "Tauira kino." + +msgid "Bad spatial key" +msgstr "Kī tauwāhi kino" + +msgid "Bar" +msgstr "Pae" + +msgid "Bar Chart" +msgstr "Kauwhata Pae" + +msgid "Bar Charts are used to show metrics as a series of bars." +msgstr "" +"Ka whakamahia ngā Kauwhata Pae ki te whakaatu i ngā ine hei raupapa pae." + +msgid "Bar Values" +msgstr "Uara Pae" + +msgid "Bar orientation" +msgstr "Ahunga pae" + +msgid "Base" +msgstr "Pūtake" + +msgid "Base exponent" +msgstr "Pūmahi pūtake" + +msgid "Base height" +msgstr "Teitei pūtake" + +#, python-format +msgid "Base layer map style. See Mapbox documentation: %s" +msgstr "Kāhua papa pūtake. Tirohia te tuhinga a Mapbox: %s" + +msgid "Base slope" +msgstr "Taha pūtake" + +msgid "Base width" +msgstr "Whānui pūtake" + +msgid "Based on a metric" +msgstr "I runga i tētahi ine" + +msgid "Based on granularity, number of time periods to compare against" +msgstr "I runga i te māeneene, te maha o ngā wā hei whakatairite" + +msgid "Based on what should series be ordered on the chart and legend" +msgstr "I runga i te aha me raupapa ai ngā raupapa i te kauwhata me te kōrero" + +msgid "Basic" +msgstr "Taketake" + +msgid "Basic information" +msgstr "Mōhiohio taketake" + +#, python-format +msgid "Batch editing %d filters:" +msgstr "Whakatika parau %d tātari:" + +msgid "Be careful." +msgstr "Kia tūpato." + +msgid "Before" +msgstr "I mua" + +msgid "Big Number" +msgstr "Tau Nui" + +msgid "Big Number Font Size" +msgstr "Rahi Momotuhi Tau Nui" + +msgid "Big Number with Time Period Comparison" +msgstr "Tau Nui me te Whakatairite Wā" + +msgid "Big Number with Trendline" +msgstr "Tau Nui me te Rārangi Ia" + +msgid "Bins" +msgstr "Pouaka" + +msgid "Border color" +msgstr "Tae tapa" + +msgid "Border width" +msgstr "Whānui tapa" + +msgid "Bottom" +msgstr "Raro" + +msgid "Bottom Margin" +msgstr "Taiapa Raro" + +msgid "Bottom left" +msgstr "Raro mauī" + +msgid "Bottom margin, in pixels, allowing for more room for axis labels" +msgstr "" +"Taiapa raro, i ngā pika, ka tukua he wāhi nui ake mō ngā tapanga tukutuku" + +msgid "Bottom right" +msgstr "Raro matau" + +msgid "Bottom to Top" +msgstr "Raro ki Runga" + +msgid "" +"Bounds for numerical X axis. Not applicable for temporal or categorical " +"axes. When left empty, the bounds are dynamically defined based on the " +"min/max of the data. Note that this feature will only expand the axis range." +" It won't narrow the data's extent." +msgstr "" +"Rohe mō te tukutuku-X tau. Karekau e hāngai mō ngā tukutuku wā, kāwai rānei." +" Mēnā ka waiho kau, ka tautuhia aunoa ngā rohe i runga i te iti/rahi o ngā " +"raraunga. Kia mōhio ka whānui anake tēnei āhuatanga i te korahi tukutuku. " +"Karekau e whāiti i te whānuitanga o ngā raraunga." + +msgid "" +"Bounds for the Y-axis. When left empty, the bounds are dynamically defined " +"based on the min/max of the data. Note that this feature will only expand " +"the axis range. It won't narrow the data's extent." +msgstr "" +"Rohe mō te tukutuku-Y. Mēnā ka waiho kau, ka tautuhia aunoa ngā rohe i runga" +" i te iti/rahi o ngā raraunga. Kia mōhio ka whānui anake tēnei āhuatanga i " +"te korahi tukutuku. Karekau e whāiti i te whānuitanga o ngā raraunga." + +msgid "" +"Bounds for the axis. When left empty, the bounds are dynamically defined " +"based on the min/max of the data. Note that this feature will only expand " +"the axis range. It won't narrow the data's extent." +msgstr "" +"Rohe mō te tukutuku. Mēnā ka waiho kau, ka tautuhia aunoa ngā rohe i runga i" +" te iti/rahi o ngā raraunga. Kia mōhio ka whānui anake tēnei āhuatanga i te " +"korahi tukutuku. Karekau e whāiti i te whānuitanga o ngā raraunga." + +msgid "" +"Bounds for the primary Y-axis. When left empty, the bounds are dynamically " +"defined based on the min/max of the data. Note that this feature will only " +"expand the axis range. It won't narrow the data's extent." +msgstr "" +"Rohe mō te tukutuku-Y matua. Mēnā ka waiho kau, ka tautuhia aunoa ngā rohe i" +" runga i te iti/rahi o ngā raraunga. Kia mōhio ka whānui anake tēnei " +"āhuatanga i te korahi tukutuku. Karekau e whāiti i te whānuitanga o ngā " +"raraunga." + +msgid "" +"Bounds for the secondary Y-axis. Only works when Independent Y-axis\n" +" bounds are enabled. When left empty, the bounds are dynamically defined\n" +" based on the min/max of the data. Note that this feature will only expand\n" +" the axis range. It won't narrow the data's extent." +msgstr "Rohe mō te tukutuku-Y tuarua. Ka mahi anake ina whakahohe i ngā rohe" + +msgid "Box Plot" +msgstr "Kauwhata Pouaka" + +msgid "Breakdowns" +msgstr "Wāwāhi" + +msgid "" +"Breaks down the series by the category specified in this control.\n" +" This can help viewers understand how each category affects the overall value." +msgstr "Ka wāwāhi i te raupapa mā te kāwai kua tohua i tēnei whakahaere." + +msgid "Bubble Chart" +msgstr "Kauwhata Pōro" + +msgid "Bubble Chart (legacy)" +msgstr "Kauwhata Pōro (tawhito)" + +msgid "Bubble Color" +msgstr "Tae Pōro" + +msgid "Bubble Opacity" +msgstr "Mātāwai Pōro" + +msgid "Bubble Size" +msgstr "Rahi Pōro" + +msgid "Bubble size" +msgstr "Rahi pōro" + +msgid "Bubble size number format" +msgstr "Hōputu tau rahi pōro" + +msgid "Bucket break points" +msgstr "Tohu wehe peeke" + +msgid "Build" +msgstr "Hanga" + +msgid "Bulk select" +msgstr "Tīpako parau" + +msgid "Bulk tag" +msgstr "Tohu parau" + +msgid "Bullet Chart" +msgstr "Kauwhata Matā" + +msgid "Business" +msgstr "Pakihi" + +msgid "" +"By default, each filter loads at most 1000 choices at the initial page load." +" Check this box if you have more than 1000 filter values and want to enable " +"dynamically searching that loads filter values as users type (may add stress" +" to your database)." +msgstr "" +"Mā te taunoa, ka uta ia tātari i te 1000 kōwhiringa nui rawa i te utanga " +"wāhanga tuatahi. Pātia tēnei pouaka mēnā he nui ake i te 1000 ō uara tātari," +" ā, e hiahia ana koe ki te whakahohe i te rapu aunoa ka uta i ngā uara " +"tātari i te wā e pato ana ngā kaiwhakamahi (ka taea pea te tāpiri i te " +"ahotea ki tō pātengi raraunga)." + +msgid "By key: use column names as sorting key" +msgstr "Mā te kī: whakamahia ngā ingoa tīwae hei kī kōmaka" + +msgid "By key: use row names as sorting key" +msgstr "Mā te kī: whakamahia ngā ingoa rārangi hei kī kōmaka" + +msgid "By value: use metric values as sorting key" +msgstr "Mā te uara: whakamahia ngā uara ine hei kī kōmaka" + +msgid "CANCEL" +msgstr "WHAKAKORE" + +msgid "CC recipients" +msgstr "Kaiwhakawhiti CC" + +msgid "CREATE DATASET" +msgstr "HANGA RĀRANGI RARAUNGA" + +msgid "CREATE TABLE AS" +msgstr "HANGA RIPANGA HEI" + +msgid "CREATE VIEW AS" +msgstr "HANGA TIROHANGA HEI" + +msgid "CREATE VIEW statement" +msgstr "Kīanga HANGA TIROHANGA" + +msgid "CRON Schedule" +msgstr "Hōtaka CRON" + +msgid "CRON expression" +msgstr "Kīanga CRON" + +msgid "CSS" +msgstr "CSS" + +msgid "CSS Styles" +msgstr "Kāhua CSS" + +msgid "CSS Templates" +msgstr "Tauira CSS" + +msgid "CSS applied to the chart" +msgstr "CSS kua whakahaeretia ki te kauwhata" + +msgid "CSS template" +msgstr "Tauira CSS" + +msgid "CSS template not found." +msgstr "Kāore i kitea te tauira CSS." + +msgid "CSS templates" +msgstr "Tauira CSS" + +msgid "CSS templates could not be deleted." +msgstr "Kāore i taea te muku i ngā tauira CSS." + +msgid "CSV upload" +msgstr "Tukuake CSV" + +msgid "CTAS & CVAS SCHEMA" +msgstr "CTAS & CVAS HANGA" + +msgid "" +"CTAS (create table as select) can only be run with a query where the last " +"statement is a SELECT. Please make sure your query has a SELECT as its last " +"statement. Then, try running your query again." +msgstr "" +"Ka taea te whakahaere i te CTAS (hanga ripanga hei tīpako) me tētahi pātai " +"kei reira ko te kīanga whakamutunga he SELECT. Tēnā kia mārama he SELECT tō " +"kīanga whakamutunga o tō pātai. Kātahi, whakamātauhia anō tō pātai." + +msgid "CUSTOM" +msgstr "RITENGA" + +msgid "" +"CVAS (create view as select) can only be run with a query with a single " +"SELECT statement. Please make sure your query has only a SELECT statement. " +"Then, try running your query again." +msgstr "" +"Ka taea te whakahaere i te CVAS (hanga tirohanga hei tīpako) me tētahi pātai" +" kotahi noa te kīanga SELECT. Tēnā kia mārama kotahi anake te kīanga SELECT " +"o tō pātai. Kātahi, whakamātauhia anō tō pātai." + +msgid "CVAS (create view as select) query has more than one statement." +msgstr "" +"He nui ake i te kotahi kīanga tō pātai CVAS (hanga tirohanga hei tīpako)." + +msgid "CVAS (create view as select) query is not a SELECT statement." +msgstr "Ehara i te kīanga SELECT te pātai CVAS (hanga tirohanga hei tīpako)." + +msgid "Cache Timeout (seconds)" +msgstr "Wā Kore-mahi Keteroki (hēkona)" + +msgid "Cache timeout" +msgstr "Wā kore-mahi keteroki" + +msgid "Cached" +msgstr "Kua Keterokihia" + +#, python-format +msgid "Cached %s" +msgstr "Kua Keterokihia %s" + +msgid "Cached value not found" +msgstr "Kāore i kitea te uara keteroki" + +msgid "Calculate contribution per series or row" +msgstr "Tatauria te whakauru ia raupapa, ia rārangi rānei" + +msgid "Calculate from first step" +msgstr "Tatauria mai i te takahanga tuatahi" + +msgid "Calculate from previous step" +msgstr "Tatauria mai i te takahanga tōmua" + +#, python-format +msgid "Calculated column [%s] requires an expression" +msgstr "E hiahiatia ana e te tīwae tatau [%s] tētahi kīanga" + +msgid "Calculated columns" +msgstr "Tīwae tatau" + +msgid "Calculation type" +msgstr "Momo tatauranga" + +msgid "Calendar Heatmap" +msgstr "Mahere Wera Maramataka" + +msgid "Can not move top level tab into nested tabs" +msgstr "Kāore e taea te neke i te ripa taumata runga ki ngā ripa whakawhāiti" + +msgid "Can select multiple values" +msgstr "Ka taea te tīpako i ngā uara maha" + +msgid "Cancel" +msgstr "Whakakore" + +msgid "Cancel query on window unload event" +msgstr "Whakakore pātai i te kaupapa tāruarunga matapihi" + +msgid "Cannot access the query" +msgstr "Kāore e taea te uru ki te pātai" + +msgid "Cannot delete a database that has datasets attached" +msgstr "" +"Kāore e taea te muku i tētahi pātengi raraunga he rārangi raraunga tūhono " +"tōna" + +#, python-format +msgid "Cannot find the table (%s) metadata." +msgstr "Kāore e kitea te ripanga (%s) metadata." + +msgid "Cannot have multiple credentials for the SSH Tunnel" +msgstr "Kāore e taea te maha o ngā taipitopito mō te SSH Tunnel" + +msgid "Cannot load filter" +msgstr "Kāore e taea te uta i te tātari" + +#, python-format +msgid "Cannot parse time string [%(human_readable)s]" +msgstr "Kāore e taea te poroporo i te aho wā [%(human_readable)s]" + +msgid "Cartodiagram" +msgstr "Cartodiagram" + +msgid "Catalog" +msgstr "Kātaloka" + +msgid "Categorical" +msgstr "Kāwai" + +msgid "Categorical Color" +msgstr "Tae Kāwai" + +msgid "Categories to group by on the x-axis." +msgstr "Kāwai hei rōpū i runga i te tukutuku-x." + +msgid "Category" +msgstr "Kāwai" + +msgid "Category Name" +msgstr "Ingoa Kāwai" + +msgid "Category and Percentage" +msgstr "Kāwai me te Ōrau" + +msgid "Category and Value" +msgstr "Kāwai me te Uara" + +msgid "Category name" +msgstr "Ingoa kāwai" + +msgid "Category of target nodes" +msgstr "Kāwai o ngā pona whāinga" + +msgid "Category, Value and Percentage" +msgstr "Kāwai, Uara me te Ōrau" + +msgid "Cell Padding" +msgstr "Pākeke Pūtau" + +msgid "Cell Radius" +msgstr "Pūtoro Pūtau" + +msgid "Cell Size" +msgstr "Rahi Pūtau" + +msgid "Cell content" +msgstr "Ihirangi pūtau" + +msgid "Cell limit" +msgstr "Tepe pūtau" + +msgid "Centroid (Longitude and Latitude): " +msgstr "Pokapū (Longitude me Latitude): " + +msgid "Certification" +msgstr "Tautūtanga" + +msgid "Certification details" +msgstr "Taipitopito tautūtanga" + +msgid "Certified" +msgstr "Kua Tautūtia" + +msgid "Certified By" +msgstr "Tautūtia e" + +msgid "Certified by" +msgstr "Tautūtia e" + +#, python-format +msgid "Certified by %s" +msgstr "Tautūtia e %s" + +msgid "Change order of columns." +msgstr "Whakarereke i te rārangi o ngā tīwae." + +msgid "Change order of rows." +msgstr "Whakarereke i te rārangi o ngā rārangi." + +msgid "Changed by" +msgstr "I whakarerekeahia e" + +msgid "Changed on" +msgstr "I whakarerekeahia i" + +msgid "Changes saved." +msgstr "Kua tiakina ngā huringa." + +msgid "Changing one or more of these dashboards is forbidden" +msgstr "He tapu te whakarereke i tētahi, i ētahi rānei o ēnei papatohu" + +msgid "" +"Changing the dataset may break the chart if the chart relies on columns or " +"metadata that does not exist in the target dataset" +msgstr "" +"Ka taea pea e te whakarereke i te rārangi raraunga te wāhi i te kauwhata " +"mēnā e whakawhirinaki ana te kauwhata ki ngā tīwae, ki ngā metadata rānei " +"kāore e tīari ana i te rārangi raraunga whāinga" + +msgid "" +"Changing these settings will affect all charts using this dataset, including" +" charts owned by other people." +msgstr "" +"Mā te whakarereke i ēnei tautuhinga ka pā ki ngā kauwhata katoa e whakamahi " +"ana i tēnei rārangi raraunga, tae atu ki ngā kauwhata nā ētahi atu tāngata." + +msgid "Changing this Dashboard is forbidden" +msgstr "He tapu te whakarereke i tēnei Papatohu" + +msgid "Changing this chart is forbidden" +msgstr "He tapu te whakarereke i tēnei kauwhata" + +msgid "Changing this control takes effect instantly" +msgstr "Ka pānga ohorere te whakarereke i tēnei whakahaere" + +msgid "Changing this dataset is forbidden" +msgstr "He tapu te whakarereke i tēnei rārangi raraunga" + +msgid "Changing this dataset is forbidden." +msgstr "He tapu te whakarereke i tēnei rārangi raraunga" + +msgid "Changing this datasource is forbidden" +msgstr "He tapu te whakarereke i tēnei puna raraunga" + +msgid "Changing this report is forbidden" +msgstr "He tapu te whakarereke i tēnei pūrongo" + +msgid "Character to interpret as decimal point" +msgstr "Pūāhua hei whakamāori hei tohu ira" + +msgid "Chart" +msgstr "Kauwhata" + +#, python-format +msgid "Chart %(id)s not found" +msgstr "Kāore i kitea te kauwhata %(id)s" + +#, python-format +msgid "Chart Data: %s" +msgstr "Raraunga Kauwhata: %s" + +msgid "Chart ID" +msgstr "ID Kauwhata" + +msgid "Chart Options" +msgstr "Kōwhiringa Kauwhata" + +msgid "Chart Orientation" +msgstr "Ahunga Kauwhata" + +#, python-format +msgid "Chart Owner: %s" +msgid_plural "Chart Owners: %s" +msgstr[0] "Rangatira Kauwhata: %s" +msgstr[1] "Rangatira Kauwhata: %s" + +msgid "Chart Source" +msgstr "Puna Kauwhata" + +msgid "Chart Title" +msgstr "Taitara Kauwhata" + +#, python-format +msgid "Chart [%s] has been overwritten" +msgstr "Kua tuhiruatia te kauwhata [%s]" + +#, python-format +msgid "Chart [%s] has been saved" +msgstr "Kua tiakina te kauwhata [%s]" + +#, python-format +msgid "Chart [%s] was added to dashboard [%s]" +msgstr "I tāpiritia te kauwhata [%s] ki te papatohu [%s]" + +msgid "Chart [{}] has been overwritten" +msgstr "Kua tuhiruatia te kauwhata [{}]" + +msgid "Chart [{}] has been saved" +msgstr "Kua tiakina te kauwhata [{}]" + +msgid "Chart [{}] was added to dashboard [{}]" +msgstr "I tāpiritia te kauwhata [{}] ki te papatohu [{}]" + +msgid "Chart cache timeout" +msgstr "Wā kore-mahi keteroki kauwhata" + +msgid "Chart changes" +msgstr "Huringa kauwhata" + +msgid "Chart could not be created." +msgstr "Kāore i taea te hanga i te kauwhata." + +msgid "Chart could not be updated." +msgstr "Kāore i taea te whakahou i te kauwhata." + +msgid "Chart does not exist" +msgstr "Karekau te kauwhata" + +msgid "Chart has no query context saved. Please save the chart again." +msgstr "" +"Karekau he horopaki pātai kua tiakina i te kauwhata. Tēnā tiakihia anō te " +"kauwhata." + +msgid "Chart height" +msgstr "Teitei kauwhata" + +msgid "Chart imported" +msgstr "Kauwhata kua kawea mai" + +msgid "Chart last modified" +msgstr "Kauwhata i whakarerekeahia whakamutunga" + +msgid "Chart last modified by" +msgstr "Kauwhata i whakarerekeahia whakamutunga e" + +msgid "Chart name" +msgstr "Ingoa kauwhata" + +msgid "Chart not found" +msgstr "Kāore i kitea te kauwhata" + +msgid "Chart options" +msgstr "Kōwhiringa kauwhata" + +msgid "Chart owners" +msgstr "Rangatira kauwhata" + +msgid "Chart parameters are invalid." +msgstr "He muhu ngā tawhā kauwhata." + +msgid "Chart properties updated" +msgstr "Kua whakahouhia ngā āhuatanga kauwhata" + +msgid "Chart size" +msgstr "Rahi kauwhata" + +msgid "Chart title" +msgstr "Taitara kauwhata" + +msgid "Chart type requires a dataset" +msgstr "E hiahiatia ana e te momo kauwhata tētahi rārangi raraunga" + +msgid "Chart width" +msgstr "Whānui kauwhata" + +msgid "Charts" +msgstr "Kauwhata" + +msgid "Charts could not be deleted." +msgstr "Kāore i taea te muku i ngā kauwhata." + +msgid "Check for sorting ascending" +msgstr "Tirohia mō te kōmaka piki" + +msgid "" +"Check if the Rose Chart should use segment area instead of segment radius " +"for proportioning" +msgstr "" +"Tirohia mēnā me whakamahi e te Kauwhata Rōhi i te horahanga wāhanga hei utu " +"mō te pūtoro wāhanga" + +msgid "Check out this chart in dashboard:" +msgstr "Tirohia tēnei kauwhata i te papatohu:" + +msgid "Check out this chart: " +msgstr "Tirohia tēnei kauwhata: " + +msgid "Check out this dashboard: " +msgstr "Tirohia tēnei papatohu: " + +msgid "Check to force date partitions to have the same height" +msgstr "Pātia kia ōrite te teitei o ngā wāhanga rā" + +msgid "Child label position" +msgstr "Tūnga tapanga tamaiti" + +msgid "Choice of [Label] must be present in [Group By]" +msgstr "Me tīari te Kōwhiringa o [Tapanga] i te [Rōpū Mā]" + +msgid "Choice of [Point Radius] must be present in [Group By]" +msgstr "Me tīari te Kōwhiringa o [Pūtoro Tohu] i te [Rōpū Mā]" + +msgid "Choose File" +msgstr "Kōwhiria Kōnae" + +msgid "Choose a chart for displaying on the map" +msgstr "Kōwhiria tētahi kauwhata hei whakaatu i runga i te mahere" + +msgid "Choose a chart or dashboard not both" +msgstr "Kōwhiria tētahi kauwhata, tētahi papatohu rānei, kaua ngā mea e rua" + +msgid "Choose a database..." +msgstr "Kōwhiria tētahi pātengi raraunga..." + +msgid "Choose a dataset" +msgstr "Kōwhiria tētahi rārangi raraunga" + +msgid "Choose a delimiter" +msgstr "Kōwhiria tētahi tohutuhi" + +msgid "Choose a metric for right axis" +msgstr "Kōwhiria tētahi ine mō te tukutuku matau" + +msgid "Choose a number format" +msgstr "Kōwhiria he hōputu tau" + +msgid "Choose a source" +msgstr "Kōwhiria he puna" + +msgid "Choose a target" +msgstr "Kōwhiria he whāinga" + +msgid "Choose already exists" +msgstr "Kua tīari kē te kōwhiringa" + +msgid "Choose chart type" +msgstr "Kōwhiri momo kauwhata" + +msgid "Choose columns to be parsed as dates" +msgstr "Kōwhiri tīwae hei poroporo hei rā" + +msgid "Choose columns to read" +msgstr "Kōwhiri tīwae hei pānui" + +msgid "Choose index column" +msgstr "Kōwhiri tīwae kuputohu" + +msgid "Choose notification method and recipients." +msgstr "Kōwhiri tikanga whakamōhio me ngā kaiwhakawhiti." + +msgid "Choose one of the available databases from the panel on the left." +msgstr "Kōwhiria tētahi o ngā pātengi raraunga wātea mai i te papa i te mauī." + +msgid "Choose one of the available databases on the left panel." +msgstr "Kōwhiria tētahi o ngā pātengi raraunga wātea i te papa mauī." + +msgid "Choose sheet name" +msgstr "Kōwhiri ingoa hīti" + +msgid "Choose the annotation layer type" +msgstr "Kōwhiri te momo papa tohu" + +msgid "Choose the format for legend values" +msgstr "Kōwhiri te hōputu mō ngā uara kōrero" + +msgid "Choose the position of the legend" +msgstr "Kōwhiri te tūnga o te kōrero" + +msgid "Choose the source of your annotations" +msgstr "Kōwhiri te puna o ō tohu" + +msgid "" +"Choose values that should be treated as null. Warning: Hive database " +"supports only a single value" +msgstr "" +"Kōwhiri uara me whakahaere hei kore. Whakatūpato: Ka tautoko te pātengi " +"raraunga Hive i te kotahi uara anake" + +msgid "" +"Choose whether a country should be shaded by the metric, or assigned a color" +" based on a categorical color palette" +msgstr "" +"Kōwhiri mēnā me marumaru tētahi whenua e te ine, me tūtohu rānei i tētahi " +"tae i runga i tētahi paka tae kāwai" + +msgid "Chord Diagram" +msgstr "Hoahoa Kōrua" + +msgid "Chosen non-numeric column" +msgstr "Tīwae kāore he tau kua kōwhiria" + +msgid "Circle" +msgstr "Porohita" + +msgid "Circle -> Arrow" +msgstr "Porohita -> Pere" + +msgid "Circle -> Circle" +msgstr "Porohita -> Porohita" + +msgid "Circle radar shape" +msgstr "Hanga whakarapa porohita" + +msgid "Circular" +msgstr "Āmiomio" + +msgid "" +"Classic row-by-column spreadsheet like view of a dataset. Use tables to " +"showcase a view into the underlying data or to show aggregated metrics." +msgstr "" +"Tirohanga ripanga tawhito rārangi-mā-tīwae o tētahi rārangi raraunga. " +"Whakamahia ngā ripanga hei whakaatu i tētahi tirohanga ki ngā raraunga e " +"takoto ana, hei whakaatu rānei i ngā ine kua whakaarotauhia." + +msgid "Clause" +msgstr "Rerenga" + +msgid "Clear" +msgstr "Whakakore" + +msgid "Clear all" +msgstr "Whakakore katoa" + +msgid "Clear all data" +msgstr "Whakakore i ngā raraunga katoa" + +msgid "Clear form" +msgstr "Whakakore puka" + +msgid "" +"Click on \"Add or Edit Filters\" option in Settings to create new dashboard " +"filters" +msgstr "" +"Pāwhiria \"Tāpiri, Whakatika rānei i ngā Tātari\" i ngā Tautuhinga hei hanga" +" tātari papatohu hou" + +msgid "" +"Click on \"Create chart\" button in the control panel on the left to preview" +" a visualization or" +msgstr "" +"Pāwhiria te pātene \"Hanga kauwhata\" i te papa whakahaere i te mauī hei " +"arokite i tētahi whakakitenga, " + +msgid "Click the lock to make changes." +msgstr "Pāwhiria te maukati hei huri." + +msgid "Click the lock to prevent further changes." +msgstr "Pāwhiria te maukati hei aukati i ngā huringa atu." + +msgid "" +"Click this link to switch to an alternate form that allows you to input the " +"SQLAlchemy URL for this database manually." +msgstr "" +"Pāwhiria tēnei hono hei huri ki tētahi puka whawhati ka taea e koe te tāuru " +"i te URL SQLAlchemy mō tēnei pātengi raraunga ā-ringa." + +msgid "" +"Click this link to switch to an alternate form that exposes only the " +"required fields needed to connect this database." +msgstr "" +"Pāwhiria tēnei hono hei huri ki tētahi puka whawhati ka whakaatu anake i ngā" +" āpure e hiahiatia ana hei hono i tēnei pātengi raraunga." + +msgid "Click to add a contour" +msgstr "Pāwhiria hei tāpiri i tētahi takotoranga" + +msgid "Click to add new layer" +msgstr "Pāwhiria hei tāpiri i tētahi papa hou" + +msgid "Click to cancel sorting" +msgstr "Pāwhiria hei whakakore i te kōmaka" + +msgid "Click to edit" +msgstr "Pāwhiria hei whakatika" + +#, python-format +msgid "Click to edit %s." +msgstr "Pāwhiria hei whakatika i %s." + +msgid "Click to edit chart." +msgstr "Pāwhiria hei whakatika i te kauwhata." + +msgid "Click to edit label" +msgstr "Pāwhiria hei whakatika i te tapanga" + +msgid "Click to favorite/unfavorite" +msgstr "Pāwhiria hei whakamakauhia/kore-whakamakauhia" + +msgid "Click to force-refresh" +msgstr "Pāwhiria hei whakahou-ā-kaha" + +msgid "Click to see difference" +msgstr "Pāwhiria hei kite i te rerekētanga" + +msgid "Click to sort ascending" +msgstr "Pāwhiria hei kōmaka piki" + +msgid "Click to sort descending" +msgstr "Pāwhiria hei kōmaka heke" + +msgid "Close" +msgstr "Kati" + +msgid "Close all other tabs" +msgstr "Kati i ngā ripa katoa kē atu" + +msgid "Close tab" +msgstr "Kati ripa" + +msgid "Cluster label aggregator" +msgstr "Kaiwhakaārotau tapanga rāpaki" + +msgid "Clustering Radius" +msgstr "Pūtoro Rāpaki" + +msgid "Code" +msgstr "Waehere" + +msgid "Collapse all" +msgstr "Hīngonga katoa" + +msgid "Collapse data panel" +msgstr "Hīngonga papa raraunga" + +msgid "Collapse row" +msgstr "Hīngonga rārangi" + +msgid "Collapse tab content" +msgstr "Hīngonga ihirangi ripa" + +msgid "Collapse table preview" +msgstr "Hīngonga arokite ripanga" + +msgid "Color" +msgstr "Tae" + +msgid "Color +/-" +msgstr "Tae +/-" + +msgid "Color Metric" +msgstr "Ine Tae" + +msgid "Color Scheme" +msgstr "Kaupapa Tae" + +msgid "Color Steps" +msgstr "Takahanga Tae" + +msgid "Color bounds" +msgstr "Rohe tae" + +msgid "Color by" +msgstr "Tae mā" + +msgid "Color metric" +msgstr "Ine tae" + +msgid "Color of the target location" +msgstr "Tae o te wāhi whāinga" + +msgid "Color scheme" +msgstr "Kaupapa tae" + +msgid "" +"Color will be shaded based the normalized (0% to 100%) value of a given cell" +" against the other cells in the selected range: " +msgstr "" +"Ka marumaru te tae i runga i te uara whakawhānuitia (0% ki 100%) o tētahi " +"pūtau ki ngā pūtau kē i te korahi kua tīpakohia: " + +msgid "Color: " +msgstr "Tae: " + +msgid "Colors" +msgstr "Tae" + +msgid "Column" +msgstr "Tīwae" + +#, python-format +msgid "" +"Column \"%(column)s\" is not numeric or does not exists in the query " +"results." +msgstr "" +"Ehara te tīwae \"%(column)s\" i te tau, karekau rānei i roto i ngā hua " +"pātai." + +msgid "Column Configuration" +msgstr "Whirihora Tīwae" + +msgid "Column Formatting" +msgstr "Hōputu Tīwae" + +msgid "Column Settings" +msgstr "Tautuhinga Tīwae" + +msgid "" +"Column containing ISO 3166-2 codes of region/province/department in your " +"table." +msgstr "" +"Tīwae kei roto ngā waehere ISO 3166-2 o te rohe/kawanatanga/tari i tō " +"ripanga." + +msgid "Column containing latitude data" +msgstr "Tīwae kei roto ngā raraunga latitude" + +msgid "Column containing longitude data" +msgstr "Tīwae kei roto ngā raraunga longitude" + +msgid "Column data types" +msgstr "Momo raraunga tīwae" + +msgid "Column header tooltip" +msgstr "Kītukutuku pane tīwae" + +msgid "Column is required" +msgstr "E hiahiatia ana te tīwae" + +msgid "Column name" +msgstr "Ingoa tīwae" + +#, python-format +msgid "Column name [%s] is duplicated" +msgstr "Kua tāruatia te ingoa tīwae [%s]" + +#, python-format +msgid "Column referenced by aggregate is undefined: %(column)s" +msgstr "" +"Kāore i tautuhia te tīwae e tohutorohia ana e te whakaarotau: %(column)s" + +msgid "Column select" +msgstr "Tīpako tīwae" + +msgid "" +"Column to use as the index of the dataframe. If None is given, Index label " +"is used." +msgstr "" +"Tīwae hei whakamahi hei kuputohu o te dataframe. Mēnā karekau he None kua " +"tukuna, ka whakamahia te tapanga kuputohu Index." + +msgid "Column type" +msgstr "Momo tīwae" + +msgid "Columnar upload" +msgstr "Tukuake tīwae pou" + +msgid "Columns" +msgstr "Tīwae" + +#, python-format +msgid "Columns (%s)" +msgstr "Tīwae (%s)" + +#, python-format +msgid "Columns missing in dataset: %(invalid_columns)s" +msgstr "Tīwae e ngaro ana i te rārangi raraunga: %(invalid_columns)s" + +#, python-format +msgid "Columns missing in datasource: %(invalid_columns)s" +msgstr "Tīwae e ngaro ana i te puna raraunga: %(invalid_columns)s" + +msgid "Columns subtotal position" +msgstr "Tūnga tapeke tīwae" + +msgid "Columns to be parsed as dates" +msgstr "Tīwae hei poroporo hei rā" + +msgid "Columns to calculate distribution across." +msgstr "Tīwae hei tatau i te tohatoha." + +msgid "Columns to display" +msgstr "Tīwae hei whakaatu" + +msgid "Columns to group by" +msgstr "Tīwae hei rōpū" + +msgid "Columns to group by on the columns" +msgstr "Tīwae hei rōpū i runga i ngā tīwae" + +msgid "Columns to group by on the rows" +msgstr "Tīwae hei rōpū i runga i ngā rārangi" + +msgid "Columns to read" +msgstr "Tīwae hei pānui" + +msgid "Combine metrics" +msgstr "Whakakotahi ine" + +msgid "" +"Comma-separated color picks for the intervals, e.g. 1,2,4. Integers denote " +"colors from the chosen color scheme and are 1-indexed. Length must be " +"matching that of interval bounds." +msgstr "" +"Tīpako tae māmā-wehea mō ngā wā, hei tauira 1,2,4. Ko ngā tau ka tohu i ngā " +"tae mai i te kaupapa tae kua kōwhiria, ā, ka tīmata i te 1. Me ōrite te roa " +"ki te roa o ngā rohe wā." + +msgid "" +"Comma-separated interval bounds, e.g. 2,4,5 for intervals 0-2, 2-4 and 4-5. " +"Last number should match the value provided for MAX." +msgstr "" +"Rohe wā māmā-wehea, hei tauira 2,4,5 mō ngā wā 0-2, 2-4 me 4-5. Me ōrite te " +"tau whakamutunga ki te uara kua whakaratohia mō te MAX." + +msgid "Comparator option" +msgstr "Kōwhiringa whakatairite" + +msgid "" +"Compare multiple time series charts (as sparklines) and related metrics " +"quickly." +msgstr "" +"Whakatairite i ngā kauwhata raupapa wā maha (hei rārangi kōhā) me ngā ine " +"hāngai tere." + +msgid "Compare results with other time periods." +msgstr "Whakatairite i ngā hua me ētahi atu wā." + +msgid "Compare the same summarized metric across multiple groups." +msgstr "Whakatairite i te ine whakarāpopoto ōrite i ngā rōpū maha." + +msgid "" +"Compares how a metric changes over time between different groups. Each group" +" is mapped to a row and change over time is visualized bar lengths and " +"color." +msgstr "" +"Ka whakatairite i te huringa o tētahi ine i te wā i waenga i ngā rōpū " +"rerekē. Ka whakaahuahia ia rōpū ki tētahi rārangi, ā, ka whakaaturia te " +"huringa i te wā mā ngā roa pae me te tae." + +msgid "Comparison" +msgstr "Whakatairite" + +msgid "Comparison Period Lag" +msgstr "Tārewa Wā Whakatairite" + +msgid "Comparison font size" +msgstr "Rahi momotuhi whakatairite" + +msgid "Comparison suffix" +msgstr "Kūmuri whakatairite" + +msgid "Compose multiple layers together to form complex visuals." +msgstr "Whakakotahi i ngā papa maha hei hanga whakakite uaua." + +msgid "Compute the contribution to the total" +msgstr "Tatau te whakauru ki te katoa" + +msgid "Condition" +msgstr "Āhuatanga" + +msgid "Conditional Formatting" +msgstr "Hōputu Āhuatanga" + +msgid "Conditional formatting" +msgstr "Hōputu āhuatanga" + +msgid "Confidence interval" +msgstr "Wā pono" + +msgid "Confidence interval must be between 0 and 1 (exclusive)" +msgstr "Me noho te wā pono i waenga i te 0 me te 1 (motuhake)" + +msgid "Configuration" +msgstr "Whirihora" + +msgid "Configure Advanced Time Range " +msgstr "Whirihora Awhe Wā Aromatawai " + +msgid "Configure Time Range: Current..." +msgstr "Whirihora Awhe Wā: Ināianei..." + +msgid "Configure Time Range: Last..." +msgstr "Whirihora Awhe Wā: Whakamutunga..." + +msgid "Configure Time Range: Previous..." +msgstr "Whirihora Awhe Wā: Tōmua..." + +msgid "Configure custom time range" +msgstr "Whirihora awhe wā ritenga" + +msgid "Configure filter scopes" +msgstr "Whirihora korahi tātari" + +msgid "Configure the basics of your Annotation Layer." +msgstr "Whirihora i ngā taketake o tō Papa Tohu." + +msgid "Configure the chart size for each zoom level" +msgstr "Whirihora i te rahi kauwhata mō ia taumata topa" + +msgid "Configure this dashboard to embed it into an external web application." +msgstr "" +"Whirihora i tēnei papatohu hei tāmau ki tētahi taupānga tukutuku o waho." + +msgid "Configure your how you overlay is displayed here." +msgstr "Whirihora i te whakaaturanga o tō kōpaki ki konei." + +msgid "Confirm Password" +msgstr "Whakaū Kupuhipa" + +msgid "Confirm overwrite" +msgstr "Whakaū tuhirua" + +msgid "Confirm save" +msgstr "Whakaū tiaki" + +msgid "Confirm the user's password" +msgstr "Whakaū i te kupuhipa o te kaiwhakamahi" + +msgid "Connect" +msgstr "Hono" + +msgid "Connect Google Sheet" +msgstr "Hono Google Sheet" + +msgid "Connect Google Sheets as tables to this database" +msgstr "Hono i ngā Google Sheets hei ripanga ki tēnei pātengi raraunga" + +msgid "Connect a database" +msgstr "Hono tētahi pātengi raraunga" + +msgid "Connect database" +msgstr "Hono pātengi raraunga" + +msgid "Connect this database using the dynamic form instead" +msgstr "Hono i tēnei pātengi raraunga mā te puka aunoa" + +msgid "Connect this database with a SQLAlchemy URI string instead" +msgstr "Hono i tēnei pātengi raraunga mā te aho URI SQLAlchemy" + +msgid "Connection" +msgstr "Hononga" + +msgid "Connection failed, please check your connection settings" +msgstr "I rahua te hononga, tēnā tirohia ō tautuhinga hononga" + +msgid "Connection failed, please check your connection settings." +msgstr "I rahua te hononga, tēnā tirohia ō tautuhinga hononga." + +msgid "Content format" +msgstr "Hōputu ihirangi" + +msgid "Content type" +msgstr "Momo ihirangi" + +msgid "Continue" +msgstr "Haere tonu" + +msgid "Continuous" +msgstr "Auau tonu" + +msgid "Contours" +msgstr "Takotoranga" + +msgid "Contribution" +msgstr "Whakauru" + +msgid "Contribution Mode" +msgstr "Aratau Whakauru" + +msgid "Control" +msgstr "Whakahaere" + +msgid "Control labeled " +msgstr "Kua tapangahia te whakahaere " + +msgid "Controls labeled " +msgstr "Kua tapangahia ngā whakahaere " + +msgid "Copied to clipboard!" +msgstr "Kua tāruatia ki te papatopenga!" + +msgid "Copy" +msgstr "Tārua" + +msgid "Copy SELECT statement" +msgstr "Tārua kīanga SELECT" + +msgid "Copy SELECT statement to the clipboard" +msgstr "Tārua kīanga SELECT ki te papatopenga" + +msgid "Copy URL" +msgstr "Tārua URL" + +msgid "Copy and Paste JSON credentials" +msgstr "Tārua me te Whakapiri i ngā taipitopito JSON" + +msgid "Copy link" +msgstr "Tārua hono" + +#, python-format +msgid "Copy of %s" +msgstr "Tārua o %s" + +msgid "Copy partition query to clipboard" +msgstr "Tārua pātai wāhanga ki te papatopenga" + +msgid "Copy permalink to clipboard" +msgstr "Tārua hononga-ā-mau ki te papatopenga" + +msgid "Copy query URL" +msgstr "Tārua URL pātai" + +msgid "Copy query link to your clipboard" +msgstr "Tārua hono pātai ki tō papatopenga" + +msgid "Copy the current data" +msgstr "Tārua i ngā raraunga o nāianei" + +msgid "Copy the identifier of the account you are trying to connect to." +msgstr "Tārua te waitohu o te kaute e ngana ana koe ki te hono." + +msgid "Copy the name of the HTTP Path of your cluster." +msgstr "Tārua te ingoa o te Ara HTTP o tō rāpaki." + +msgid "Copy the name of the database you are trying to connect to." +msgstr "Tārua te ingoa o te pātengi raraunga e ngana ana koe ki te hono." + +msgid "Copy to Clipboard" +msgstr "Tārua ki te Papatopenga" + +msgid "Copy to clipboard" +msgstr "Tārua ki te papatopenga" + +msgid "Corner Radius" +msgstr "Pūtoro Koki" + +msgid "Correlation" +msgstr "Hononga" + +msgid "Cost estimate" +msgstr "Utu tauwhitinga" + +#, python-format +msgid "Could not connect to database: \"%(database)s\"" +msgstr "Kāore i taea te hono ki te pātengi raraunga: \"%(database)s\"" + +msgid "Could not determine datasource type" +msgstr "Kāore i taea te whakatau i te momo puna raraunga" + +msgid "Could not fetch all saved charts" +msgstr "Kāore i taea te tiki i ngā kauwhata katoa kua tiakina" + +msgid "Could not find viz object" +msgstr "Kāore i kitea te ahanoa viz" + +msgid "Could not load database driver" +msgstr "Kāore i taea te uta i te taraiwa pātengi raraunga" + +msgid "Could not load database driver: {}" +msgstr "Kāore i taea te uta i te taraiwa pātengi raraunga: {}" + +#, python-format +msgid "Could not resolve hostname: \"%(host)s\"." +msgstr "Kāore i taea te whakaoti i te ingoa tūmau: \"%(host)s\"." + +msgid "Could not validate the user in the current session." +msgstr "Kāore i taea te manatoko i te kaiwhakamahi i te wātaka o nāianei." + +msgid "Count" +msgstr "Tatau" + +msgid "Count Unique Values" +msgstr "Tatau Uara Ahurei" + +msgid "Count as Fraction of Columns" +msgstr "Tatau hei Hautanga o ngā Tīwae" + +msgid "Count as Fraction of Rows" +msgstr "Tatau hei Hautanga o ngā Rārangi" + +msgid "Count as Fraction of Total" +msgstr "Tatau hei Hautanga o te Katoa" + +msgid "Country" +msgstr "Whenua" + +msgid "Country Color Scheme" +msgstr "Kaupapa Tae Whenua" + +msgid "Country Column" +msgstr "Tīwae Whenua" + +msgid "Country Field Type" +msgstr "Momo Āpure Whenua" + +msgid "Country Map" +msgstr "Mahere Whenua" + +msgid "Create" +msgstr "Hanga" + +msgid "Create chart" +msgstr "Hanga kauwhata" + +msgid "Create a dataset" +msgstr "Hanga rārangi raraunga" + +msgid "" +"Create a dataset to begin visualizing your data as a chart or go to\n" +" SQL Lab to query your data." +msgstr "" +"Hangaia he rārangi raraunga hei tīmata i te whakakite i ō raraunga hei " +"kauwhata, haere rānei ki" + +msgid "Create a new chart" +msgstr "Hangaia he kauwhata hou" + +msgid "Create chart with dataset" +msgstr "Hanga kauwhata me te rārangi raraunga" + +msgid "Create dataframe index" +msgstr "Hanga kuputohu dataframe" + +msgid "Create dataset" +msgstr "Hanga rārangi raraunga" + +msgid "Create dataset and create chart" +msgstr "Hanga rārangi raraunga me te hanga kauwhata" + +msgid "Create new chart" +msgstr "Hanga kauwhata hou" + +msgid "Create or select schema..." +msgstr "Hanga, tīpako rānei i te hanga..." + +msgid "Created" +msgstr "Kua Hangaia" + +msgid "Created by" +msgstr "I hangaia e" + +msgid "Created by me" +msgstr "I hangaia e au" + +msgid "Created on" +msgstr "I hangaia i" + +msgid "Creating SSH Tunnel failed for an unknown reason" +msgstr "" +"I rahua te hanganga o te Pūaha SSH mō tētahi take kāore e mōhiotia ana" + +msgid "Creating a data source and creating a new tab" +msgstr "E hanga ana i tētahi puna raraunga me te hanga i tētahi ripa hou" + +msgid "Creator" +msgstr "Kaihanga" + +msgid "Credentials uploaded" +msgstr "Kua tukuaketia ngā taipitopito" + +msgid "Crimson" +msgstr "Ngā" + +msgid "" +"Cross-filter will be applied to all of the charts that use this dataset." +msgstr "" +"Ka whakahaeretia te tātari-whiti ki ngā kauwhata katoa e whakamahi ana i " +"tēnei rārangi raraunga." + +msgid "Cross-filtering is not enabled for this dashboard." +msgstr "Kāore i whakahohengia te tātari-whiti mō tēnei papatohu." + +msgid "Cross-filtering is not enabled in this dashboard" +msgstr "Kāore i whakahohengia te tātari-whiti i tēnei papatohu" + +msgid "Cross-filtering scoping" +msgstr "Korahi tātari-whiti" + +msgid "Cross-filters" +msgstr "Tātari-whiti" + +msgid "Cumulative" +msgstr "Whakakōputu" + +msgid "Currency" +msgstr "Moni" + +msgid "Currency format" +msgstr "Hōputu moni" + +msgid "Currency prefix or suffix" +msgstr "Kūmua, kūmuri moni rānei" + +msgid "Currency symbol" +msgstr "Tohu moni" + +msgid "Current" +msgstr "O Nāianei" + +msgid "Current day" +msgstr "Rā o nāianei" + +msgid "Current month" +msgstr "Marama o nāianei" + +msgid "Current quarter" +msgstr "Hautakiwā o nāianei" + +msgid "Current week" +msgstr "Wiki o nāianei" + +msgid "Current year" +msgstr "Tau o nāianei" + +#, python-format +msgid "Currently rendered: %s" +msgstr "Kua whakaaturia o nāianei: %s" + +msgid "Custom" +msgstr "Ritenga" + +msgid "Custom conditional formatting" +msgstr "Hōputu āhuatanga ritenga" + +msgid "Custom Plugin" +msgstr "Mono Ritenga" + +msgid "Custom Plugins" +msgstr "Mono Ritenga" + +msgid "Custom SQL" +msgstr "SQL Ritenga" + +msgid "Custom SQL ad-hoc metrics are not enabled for this dataset" +msgstr "" +"Kāore i whakahohengia ngā ine ad-hoc SQL Ritenga mō tēnei rārangi raraunga" + +msgid "Custom SQL fields cannot contain sub-queries." +msgstr "Kāore e taea e ngā āpure SQL Ritenga te whai i ngā pātai-iti." + +msgid "Custom color palettes" +msgstr "Paka tae ritenga" + +msgid "Custom column name (leave blank for default)" +msgstr "Ingoa tīwae ritenga (waiho kau mō te taunoa)" + +msgid "Custom date" +msgstr "Rā ritenga" + +msgid "Custom interval" +msgstr "Wā ritenga" + +msgid "Custom time filter plugin" +msgstr "Mono tātari wā ritenga" + +msgid "Custom width of the screenshot in pixels" +msgstr "Whānui ritenga o te hopuataata i ngā pika" + +msgid "Customize" +msgstr "Whakaritenga" + +msgid "Customize Metrics" +msgstr "Whakaritenga Ine" + +msgid "" +"Customize chart metrics or columns with currency symbols as prefixes or " +"suffixes. Choose a symbol from dropdown or type your own." +msgstr "" +"Whakarite i ngā ine kauwhata, i ngā tīwae rānei me ngā tohu moni hei kūmua, " +"hei kūmuri rānei. Kōwhiria he tohu mai i te taka iho, pato rānei i tō ake." + +msgid "Customize columns" +msgstr "Whakaritenga tīwae" + +msgid "Customize data source, filters, and layout." +msgstr "Whakaritenga puna raraunga, tātari, me te hoahoa." + +msgid "Cyclic dependency detected" +msgstr "I kitea te whakawhirinaki āmiomio" + +msgid "D3 format" +msgstr "Hōputu D3" + +msgid "D3 format syntax: https://github.com/d3/d3-format" +msgstr "Wetereo hōputu D3: https://github.com/d3/d3-format" + +msgid "" +"D3 number format for numbers between -1.0 and 1.0, useful when you want to " +"have different significant digits for small and large numbers" +msgstr "" +"Hōputu tau D3 mō ngā tau i waenga i -1.0 me 1.0, he whaihua ina hiahia koe " +"ki ngā mati hiranga rerekē mō ngā tau iti me ngā tau nui" + +msgid "D3 time format for datetime columns" +msgstr "Hōputu wā D3 mō ngā tīwae datetime" + +msgid "D3 time format syntax: https://github.com/d3/d3-time-format" +msgstr "Wetereo hōputu wā D3: https://github.com/d3/d3-time-format" + +msgid "DATETIME" +msgstr "DATETIME" + +#, python-format +msgid "DB column %(col_name)s has unknown type: %(value_type)s" +msgstr "" +"He kāore e mōhiotia te momo o te tīwae DB %(col_name)s: %(value_type)s" + +msgid "DD/MM format dates, international and European format" +msgstr "Rā hōputu DD/MM, hōputu ao me Ūropi" + +msgid "DEC" +msgstr "HAK" + +msgid "DELETE" +msgstr "MUKU" + +msgid "DML" +msgstr "DML" + +msgid "Daily seasonality" +msgstr "Wātanga wā ia rā" + +msgid "Dark" +msgstr "Pōuri" + +msgid "Dark Cyan" +msgstr "Kawariki Pōuri" + +msgid "Dark mode" +msgstr "Aratau pōuri" + +msgid "Dashboard" +msgstr "Papatohu" + +#, python-format +msgid "Dashboard [%s] just got created and chart [%s] was added to it" +msgstr "Kua hangaia te Papatohu [%s], ā, kua tāpiritia te kauwhata [%s]" + +msgid "Dashboard [{}] just got created and chart [{}] was added to it" +msgstr "Kua hangaia te Papatohu [{}], ā, kua tāpiritia te kauwhata [{}]" + +msgid "Dashboard cannot be copied due to invalid parameters." +msgstr "Kāore e taea te tārua i te papatohu nā te tawhā muhu." + +msgid "Dashboard cannot be favorited." +msgstr "Kāore e taea te whakamakauhia te papatohu." + +msgid "Dashboard cannot be unfavorited." +msgstr "Kāore e taea te kore-whakamakauhia te papatohu." + +msgid "Dashboard color configuration could not be updated." +msgstr "Kāore i taea te whakahou i te whirihora tae papatohu." + +msgid "Dashboard could not be deleted." +msgstr "Kāore i taea te muku i te papatohu." + +msgid "Dashboard could not be updated." +msgstr "Kāore i taea te whakahou i te papatohu." + +msgid "Dashboard does not exist" +msgstr "Karekau te papatohu" + +msgid "Dashboard imported" +msgstr "Papatohu kua kawemaihia" + +msgid "Dashboard native filters could not be patched." +msgstr "Kāore i taea te pani i ngā tātari taketake papatohu." + +msgid "Dashboard parameters are invalid." +msgstr "He muhu ngā tawhā papatohu." + +msgid "Dashboard properties" +msgstr "Āhuatanga papatohu" + +msgid "Dashboard properties updated" +msgstr "Kua whakahouhia ngā āhuatanga papatohu" + +msgid "Dashboard scheme" +msgstr "Kaupapa papatohu" + +msgid "" +"Dashboard time range filters apply to temporal columns defined in\n" +" the filter section of each chart. Add temporal columns to the chart\n" +" filters to have this dashboard filter impact those charts." +msgstr "Ka pā ngā tātari awhe wā papatohu ki ngā tīwae wā kua tautuhia i" + +msgid "Dashboard title" +msgstr "Taitara papatohu" + +msgid "Dashboard usage" +msgstr "Whakamahinga papatohu" + +msgid "Dashboards" +msgstr "Papatohu" + +msgid "Dashboards could not be created." +msgstr "Kāore i taea te hanga i ngā papatohu." + +msgid "Dashboards do not exist" +msgstr "Karekau ngā papatohu" + +msgid "Dashed" +msgstr "Kani" + +msgid "Data" +msgstr "Raraunga" + +msgid "Data Table" +msgstr "Ripanga Raraunga" + +msgid "Data URI is not allowed." +msgstr "Karekau e whakāetia te URI Raraunga." + +msgid "Data Zoom" +msgstr "Topa Raraunga" + +msgid "" +"Data could not be deserialized from the results backend. The storage format " +"might have changed, rendering the old data stake. You need to re-run the " +"original query." +msgstr "" +"Kāore i taea te whakaoti i ngā raraunga mai i te tuarongo hua. Kua rerekē " +"pea te hōputu penapena, ka kore ai ngā raraunga tawhito. Me whakahaere anō " +"koe i te pātai taketake." + +msgid "" +"Data could not be retrieved from the results backend. You need to re-run the" +" original query." +msgstr "" +"Kāore i taea te tiki i ngā raraunga mai i te tuarongo hua. Me whakahaere anō" +" koe i te pātai taketake." + +#, python-format +msgid "Data for %s" +msgstr "Raraunga mō %s" + +msgid "Data imported" +msgstr "Raraunga kua kawemai" + +msgid "Data preview" +msgstr "Arokite raraunga" + +msgid "Data refreshed" +msgstr "Raraunga kua whakahouhia" + +msgid "Data type" +msgstr "Momo raraunga" + +msgid "DataFrame include at least one series" +msgstr "Me whai te DataFrame i te kotahi raupapa nui rawa" + +msgid "DataFrame must include temporal column" +msgstr "Me whai te DataFrame i te tīwae wā" + +msgid "Database" +msgstr "Pātengi Raraunga" + +msgid "Database Connections" +msgstr "Hononga Pātengi Raraunga" + +msgid "Database Creation Error" +msgstr "Hapa Hanganga Pātengi Raraunga" + +msgid "Database connected" +msgstr "Pātengi raraunga kua honoa" + +msgid "Database could not be created." +msgstr "Kāore i taea te hanga i te pātengi raraunga." + +msgid "Database could not be deleted." +msgstr "Kāore i taea te muku i te pātengi raraunga." + +msgid "Database could not be updated." +msgstr "Kāore i taea te whakahou i te pātengi raraunga." + +msgid "Database does not allow data manipulation." +msgstr "Karekau e whakāe te pātengi raraunga ki te whakahaere raraunga." + +msgid "Database does not exist" +msgstr "Karekau te pātengi raraunga" + +msgid "Database does not support subqueries" +msgstr "Karekau e tautoko te pātengi raraunga i ngā pātai-iti" + +msgid "" +"Database driver for importing maybe not installed. Visit the Superset " +"documentation page for installation instructions: " +msgstr "" +"Kāhore pea kua tāutahia te taraiwa pātengi raraunga mō te kawemai. Haere ki " +"te whārangi tuhinga a Superset mō ngā tohutohu tāuta: " + +msgid "Database error" +msgstr "Hapa pātengi raraunga" + +msgid "Database is offline." +msgstr "Kei tuimotu te pātengi raraunga." + +msgid "Database is required for alerts" +msgstr "E hiahiatia ana he pātengi raraunga mō ngā matohi" + +msgid "Database name" +msgstr "Ingoa pātengi raraunga" + +msgid "Database not allowed to change" +msgstr "Karekau e whakāetia te huri i te pātengi raraunga" + +msgid "Database not found." +msgstr "Kāore i kitea te pātengi raraunga." + +msgid "Database parameters are invalid." +msgstr "He muhu ngā tawhā pātengi raraunga." + +msgid "Database passwords" +msgstr "Kupuhipa pātengi raraunga" + +msgid "Database port" +msgstr "Tauranga pātengi raraunga" + +msgid "Database schema is not allowed for csv uploads." +msgstr "Karekau e whakāetia te hanga pātengi raraunga mō ngā tukuake csv." + +msgid "Database settings updated" +msgstr "Kua whakahouhia ngā tautuhinga pātengi raraunga" + +msgid "Database type does not support file uploads." +msgstr "Karekau e tautoko te momo pātengi raraunga i ngā tukuake kōnae." + +msgid "Database upload file failed" +msgstr "I rahua te tukuake kōnae pātengi raraunga" + +msgid "Database upload file failed, while saving metadata" +msgstr "I rahua te tukuake kōnae pātengi raraunga, i te tiakitanga metadata" + +msgid "Databases" +msgstr "Pātengi Raraunga" + +msgid "Dataset" +msgstr "Rārangi Raraunga" + +#, python-format +msgid "Dataset %(table)s already exists" +msgstr "Kei te tīari kē te rārangi raraunga %(table)s" + +msgid "Dataset Name" +msgstr "Ingoa Rārangi Raraunga" + +msgid "Dataset column delete failed." +msgstr "I rahua te muku tīwae rārangi raraunga." + +msgid "Dataset column not found." +msgstr "Kāore i kitea te tīwae rārangi raraunga." + +msgid "Dataset could not be created." +msgstr "Kāore i taea te hanga i te rārangi raraunga." + +msgid "Dataset could not be duplicated." +msgstr "Kāore i taea te tārua i te rārangi raraunga." + +msgid "Dataset could not be updated." +msgstr "Kāore i taea te whakahou i te rārangi raraunga." + +msgid "Dataset does not exist" +msgstr "Karekau te rārangi raraunga" + +msgid "Dataset imported" +msgstr "Rārangi raraunga kua kawemai" + +msgid "Dataset is required" +msgstr "E hiahiatia ana he rārangi raraunga" + +msgid "Dataset metric delete failed." +msgstr "I rahua te muku ine rārangi raraunga." + +msgid "Dataset metric not found." +msgstr "Kāore i kitea te ine rārangi raraunga." + +msgid "Dataset name" +msgstr "Ingoa rārangi raraunga" + +msgid "Dataset parameters are invalid." +msgstr "He muhu ngā tawhā rārangi raraunga." + +#, python-format +msgid "Dataset schema is invalid, caused by: %(error)s" +msgstr "He muhu te hanga rārangi raraunga, nā: %(error)s" + +msgid "Datasets" +msgstr "Rārangi Raraunga" + +msgid "" +"Datasets can be created from database tables or SQL queries. Select a " +"database table to the left or " +msgstr "" +"Ka taea te hanga i ngā rārangi raraunga mai i ngā ripanga pātengi raraunga, " +"mai i ngā pātai SQL rānei. Tīpakohia tētahi ripanga pātengi raraunga ki te " +"mauī, " + +msgid "Datasets could not be deleted." +msgstr "Kāore i taea te muku i ngā rārangi raraunga." + +msgid "Datasets do not contain a temporal column" +msgstr "Karekau he tīwae wā i roto i ngā rārangi raraunga" + +msgid "Datasource" +msgstr "Puna Raraunga" + +msgid "Datasource & Chart Type" +msgstr "Puna Raraunga & Momo Kauwhata" + +msgid "Datasource does not exist" +msgstr "Karekau te puna raraunga" + +msgid "Datasource type is invalid" +msgstr "He muhu te momo puna raraunga" + +msgid "Datasource type is required when datasource_id is given" +msgstr "E hiahiatia ana te momo puna raraunga ina tukuna te datasource_id" + +msgid "Date Time Format" +msgstr "Hōputu Wā Rā" + +msgid "Date format" +msgstr "Hōputu rā" + +msgid "Date format string" +msgstr "Aho hōputu rā" + +msgid "Date/Time" +msgstr "Rā/Wā" + +msgid "" +"Datetime column not provided as part table configuration and is required by " +"this type of chart" +msgstr "" +"Kāore i tukuna te tīwae wā hei wāhanga o te whirihora ripanga, ā, e " +"hiahiatia ana e tēnei momo kauwhata" + +msgid "Datetime format" +msgstr "Hōputu wā" + +msgid "Day" +msgstr "Rā" + +msgid "Day (freq=D)" +msgstr "Rā (freq=D)" + +#, python-format +msgid "Days %s" +msgstr "Rā %s" + +msgid "Db engine did not return all queried columns" +msgstr "Kāore i whakahoki mai e te pūkaha db ngā tīwae katoa i pātaihia" + +msgid "Deactivate" +msgstr "Whakakorehia" + +msgid "December" +msgstr "Hakihea" + +msgid "Decides which column or measure to sort the base axis by." +msgstr "" +"Ka whakatau ko tēhea tīwae, ko tēhea ine rānei hei kōmaka i te tukutuku " +"pūtake." + +msgid "Decimal character" +msgstr "Pūāhua ira" + +msgid "Deck.gl - 3D Grid" +msgstr "Deck.gl - Tukutata 3D" + +msgid "Deck.gl - 3D HEX" +msgstr "Deck.gl - HEX 3D" + +msgid "Deck.gl - Arc" +msgstr "Deck.gl - Kopeka" + +msgid "Deck.gl - Contour" +msgstr "Deck.gl - Takotoranga" + +msgid "Deck.gl - GeoJSON" +msgstr "Deck.gl - GeoJSON" + +msgid "Deck.gl - Heatmap" +msgstr "Deck.gl - Mahere Wera" + +msgid "Deck.gl - Multiple Layers" +msgstr "Deck.gl - Papa Maha" + +msgid "Deck.gl - Paths" +msgstr "Deck.gl - Ara" + +msgid "Deck.gl - Polygon" +msgstr "Deck.gl - Tapawhā" + +msgid "Deck.gl - Scatter plot" +msgstr "Deck.gl - Kauwhata marara" + +msgid "Deck.gl - Screen Grid" +msgstr "Deck.gl - Tukutata Mata" + +msgid "Decrease" +msgstr "Heke" + +msgid "Default Catalog" +msgstr "Kātaloka Taunoa" + +msgid "Default Schema" +msgstr "Hanga Taunoa" + +msgid "Default URL" +msgstr "URL Taunoa" + +msgid "" +"Default URL to redirect to when accessing from the dataset list page.\n" +" Accepts relative URLs such as /superset/dashboard/{id}/" +msgstr "" +"URL Taunoa hei whakawhiti atu ina urunga mai i te whārangi rārangi rārangi " +"raraunga." + +msgid "Default Value" +msgstr "Uara Taunoa" + +msgid "Default datetime" +msgstr "Wā taunoa" + +msgid "Default latitude" +msgstr "Latitude taunoa" + +msgid "Default longitude" +msgstr "Longitude taunoa" + +msgid "" +"Default minimal column width in pixels, actual width may still be larger " +"than this if other columns don't need much space" +msgstr "" +"Whānui tīwae iti taunoa i ngā pika, ka taea e te whānui tūturu te rahi ake i" +" tēnei mēnā karekau e hiahiatia e ētahi atu tīwae te wāhi nui" + +msgid "Default value must be set when \"Filter has default value\" is checked" +msgstr "Me tautuhi te uara taunoa ina pātia \"He uara taunoa tō te Tātari\"" + +msgid "Default value must be set when \"Filter value is required\" is checked" +msgstr "Me tautuhi te uara taunoa ina pātia \"E hiahiatia ana te uara tātari\"" + +msgid "" +"Default value set automatically when \"Select first filter value by " +"default\" is checked" +msgstr "" +"Ka tautuhi aunoa te uara taunoa ina pātia \"Tīpakohia te uara tātari tuatahi" +" mā te taunoa\"" + +msgid "" +"Define a function that receives the input and outputs the content for a " +"tooltip" +msgstr "" +"Tautuhia he taumahi ka whakawhiti i te tāuru, ā, ka puta te ihirangi mō " +"tētahi kītukutuku" + +msgid "Define a function that returns a URL to navigate to when user clicks" +msgstr "" +"Tautuhia he taumahi ka whakahoki i tētahi URL hei whakatere atu ina pāwhiria" +" e te kaiwhakamahi" + +msgid "" +"Define a javascript function that receives the data array used in the " +"visualization and is expected to return a modified version of that array. " +"This can be used to alter properties of the data, filter, or enrich the " +"array." +msgstr "" +"Tautuhia he taumahi javascript ka whakawhiti i te huinga raraunga kua " +"whakamahia i te whakakitenga, ā, e tūmanakohia ana ka whakahoki i tētahi " +"putanga kua whakarerekeahia o taua huinga. Ka taea te whakamahi i tēnei hei " +"huri i ngā āhuatanga o ngā raraunga, hei tātari, hei whakanui rānei i te " +"huinga." + +msgid "" +"Define contour layers. Isolines represent a collection of line segments that" +" serparate the area above and below a given threshold. Isobands represent a " +"collection of polygons that fill the are containing values in a given " +"threshold range." +msgstr "" +"Tautuhia ngā papa takotoranga. Ko ngā Isoline he kohinga o ngā wāhanga " +"rārangi ka wehe i te horahanga i runga, i raro rānei i tētahi paepae kua " +"tukuna. Ko ngā Isoband he kohinga tapawhā ka whakakī i te horahanga kei roto" +" ngā uara i tētahi awhe paepae kua tukuna." + +msgid "Define delivery schedule, timezone, and frequency settings." +msgstr "Tautuhi hōtaka tuku, rohe wā, me ngā tautuhinga auau." + +msgid "Define the database, SQL query, and triggering conditions for alert." +msgstr "" +"Tautuhi te pātengi raraunga, te pātai SQL, me ngā āhuatanga whakaohonga mō " +"te matohi." + +msgid "" +"Defines a rolling window function to apply, works along with the [Periods] " +"text box" +msgstr "" +"Ka tautuhi i tētahi taumahi matapihi takahuri hei whakahaeretia, ka mahi " +"tahi me te pouaka kupu [Wā]" + +msgid "Defines the grid size in pixels" +msgstr "Ka tautuhi i te rahi tukutata i ngā pika" + +msgid "" +"Defines the grouping of entities. Each series is represented by a specific " +"color in the chart." +msgstr "" +"Ka tautuhi i te rōpūtanga o ngā pūtahi. Ko ia raupapa e tohua ana e tētahi " +"tae motuhake i te kauwhata." + +msgid "" +"Defines the grouping of entities. Each series is shown as a specific color " +"on the chart and has a legend toggle" +msgstr "" +"Ka tautuhi i te rōpūtanga o ngā pūtahi. Ka whakaaturia ia raupapa hei tae " +"motuhake i te kauwhata, ā, he pātene kōrero" + +msgid "" +"Defines the size of the rolling window function, relative to the time " +"granularity selected" +msgstr "" +"Ka tautuhi i te rahi o te taumahi matapihi takahuri, tata ki te māeneene wā " +"kua tīpakohia" + +msgid "" +"Defines the value that determines the boundary between different regions or " +"levels in the data " +msgstr "" +"Ka tautuhi i te uara ka whakatau i te rohe i waenga i ngā rohe rerekē, i ngā" +" taumata rānei i roto i ngā raraunga " + +msgid "" +"Defines whether the step should appear at the beginning, middle or end " +"between two data points" +msgstr "" +"Ka tautuhi mēnā me puta te takahanga i te tīmatanga, i waenga, i te mutunga " +"rānei i waenga i ngā tohu raraunga e rua" + +msgid "Delete" +msgstr "Muku" + +#, python-format +msgid "Delete %s?" +msgstr "Muku %s?" + +msgid "Delete Annotation?" +msgstr "Muku Tohu?" + +msgid "Delete Database?" +msgstr "Muku Pātengi Raraunga?" + +msgid "Delete Dataset?" +msgstr "Muku Rārangi Raraunga?" + +msgid "Delete Layer?" +msgstr "Muku Papa?" + +msgid "Delete Query?" +msgstr "Muku Pātai?" + +msgid "Delete Report?" +msgstr "Muku Pūrongo?" + +msgid "Delete Role?" +msgstr "Muku Tūranga?" + +msgid "Delete Template?" +msgstr "Muku Tauira?" + +msgid "Delete User?" +msgstr "Muku Kaiwhakamahi?" + +msgid "Delete all Really?" +msgstr "Muku katoa Tino hiahia?" + +msgid "Delete annotation" +msgstr "Muku tohu" + +msgid "Delete dashboard tab?" +msgstr "Muku ripa papatohu?" + +msgid "Delete database" +msgstr "Muku pātengi raraunga" + +msgid "Delete email report" +msgstr "Muku pūrongo īmēra" + +msgid "Delete query" +msgstr "Muku pātai" + +msgid "Delete role" +msgstr "Muku tūranga" + +msgid "Delete template" +msgstr "Muku tauira" + +msgid "Delete this container and save to remove this message." +msgstr "Mukua tēnei pouaka, ā, tiakihia kia kore ai tēnei karere." + +msgid "Delete user" +msgstr "Muku kaiwhakamahi" + +msgid "Deleted" +msgstr "Kua Mukua" + +#, python-format +msgid "Deleted %(num)d annotation" +msgid_plural "Deleted %(num)d annotations" +msgstr[0] "Kua mukua %(num)d tohu" +msgstr[1] "Kua mukua %(num)d tohu" + +#, python-format +msgid "Deleted %(num)d annotation layer" +msgid_plural "Deleted %(num)d annotation layers" +msgstr[0] "Kua mukua %(num)d papa tohu" +msgstr[1] "Kua mukua %(num)d papa tohu" + +#, python-format +msgid "Deleted %(num)d chart" +msgid_plural "Deleted %(num)d charts" +msgstr[0] "Kua mukua %(num)d kauwhata" +msgstr[1] "Kua mukua %(num)d kauwhata" + +#, python-format +msgid "Deleted %(num)d css template" +msgid_plural "Deleted %(num)d css templates" +msgstr[0] "Kua mukua %(num)d tauira css" +msgstr[1] "Kua mukua %(num)d tauira css" + +#, python-format +msgid "Deleted %(num)d dashboard" +msgid_plural "Deleted %(num)d dashboards" +msgstr[0] "Kua mukua %(num)d papatohu" +msgstr[1] "Kua mukua %(num)d papatohu" + +#, python-format +msgid "Deleted %(num)d dataset" +msgid_plural "Deleted %(num)d datasets" +msgstr[0] "Kua mukua %(num)d rārangi raraunga" +msgstr[1] "Kua mukua %(num)d rārangi raraunga" + +#, python-format +msgid "Deleted %(num)d report schedule" +msgid_plural "Deleted %(num)d report schedules" +msgstr[0] "Kua mukua %(num)d hōtaka pūrongo" +msgstr[1] "Kua mukua %(num)d hōtaka pūrongo" + +#, python-format +msgid "Deleted %(num)d rules" +msgid_plural "Deleted %(num)d rules" +msgstr[0] "Kua mukua %(num)d ture" +msgstr[1] "Kua mukua %(num)d ture" + +#, python-format +msgid "Deleted %(num)d saved query" +msgid_plural "Deleted %(num)d saved queries" +msgstr[0] "Kua mukua %(num)d pātai kua tiakina" +msgstr[1] "Kua mukua %(num)d pātai kua tiakina" + +#, python-format +msgid "Deleted %s" +msgstr "Kua Mukua %s" + +#, python-format +msgid "Deleted role: %s" +msgstr "Tūranga kua mukua: %s" + +#, python-format +msgid "Deleted roles: %s" +msgstr "Tūranga kua mukua: %s" + +#, python-format +msgid "Deleted user: %s" +msgstr "Kaiwhakamahi kua mukua: %s" + +#, python-format +msgid "Deleted users: %s" +msgstr "Kaiwhakamahi kua mukua: %s" + +#, python-format +msgid "Deleted: %s" +msgstr "Kua Mukua: %s" + +msgid "" +"Deleting a tab will remove all content within it and will deactivate any " +"related alerts or reports. You may still reverse this action with the" +msgstr "" +"Mā te muku i tētahi ripa ka tangohia ngā ihirangi katoa i roto, ā, ka " +"whakakore i ngā matohi, i ngā pūrongo hāngai rānei. Ka taea tonu e koe te " +"whakahoki i tēnei mahi mā te" + +msgid "Delimited long & lat single column" +msgstr "Tīwae kotahi lat me long wehea roa" + +msgid "Delimiter" +msgstr "Tohutuhi" + +msgid "Delivery method" +msgstr "Tikanga tuku" + +msgid "Density" +msgstr "Matotoru" + +msgid "Dependent on" +msgstr "E whakawhirinaki ana ki" + +msgid "Description" +msgstr "Whakamārama" + +msgid "Description (this can be seen in the list)" +msgstr "Whakamārama (ka taea te kite i roto i te rārangi)" + +msgid "Description Columns" +msgstr "Tīwae Whakamārama" + +msgid "Description text that shows up below your Big Number" +msgstr "Kupu whakamārama ka puta i raro i tō Tau Nui" + +msgid "Deselect all" +msgstr "Kore-tīpakohia te katoa" + +msgid "Details" +msgstr "Taipitopito" + +msgid "Details of the certification" +msgstr "Taipitopito o te tautūtanga" + +msgid "Determines how whiskers and outliers are calculated." +msgstr "Ka whakatau i te tataunga o ngā whīhau me ngā wāhitauwehe." + +msgid "" +"Determines whether or not this dashboard is visible in the list of all " +"dashboards" +msgstr "" +"Ka whakatau mēnā kei te kitea tēnei papatohu i te rārangi papatohu katoa" + +msgid "Diamond" +msgstr "Taimana" + +msgid "Did you mean:" +msgstr "I kī koe:" + +msgid "Difference" +msgstr "Rerekētanga" + +msgid "Dim Gray" +msgstr "Hina Kōnehunehu" + +msgid "Dimension" +msgstr "Āhuahanga" + +msgid "Dimension to use on x-axis." +msgstr "Āhuahanga hei whakamahi i te tukutuku-x." + +msgid "Dimension to use on y-axis." +msgstr "Āhuahanga hei whakamahi i te tukutuku-y." + +msgid "Dimensions" +msgstr "Āhuahanga" + +msgid "" +"Dimensions contain qualitative values such as names, dates, or geographical " +"data. Use dimensions to categorize, segment, and reveal the details in your " +"data. Dimensions affect the level of detail in the view." +msgstr "" +"Kei roto i ngā āhuahanga ngā uara kounga pērā i ngā ingoa, ngā rā, ngā " +"raraunga takiwā rānei. Whakamahia ngā āhuahanga hei whakarōpū, hei wāhanga, " +"hei whakaatu hoki i ngā taipitopito o ō raraunga. Ka pā ngā āhuahanga ki te " +"taumata taipitopito o te tirohanga." + +msgid "Directed Force Layout" +msgstr "Takotoranga Kaha Ahunga" + +msgid "Directional" +msgstr "Ahunga" + +msgid "Disable SQL Lab data preview queries" +msgstr "Whakakore i ngā pātai arokite raraunga SQL Lab" + +msgid "" +"Disable data preview when fetching table metadata in SQL Lab. Useful to " +"avoid browser performance issues when using databases with very wide " +"tables." +msgstr "" +"Whakakore i te arokite raraunga ina tiki metadata ripanga i SQL Lab. He " +"whaihua hei karo i ngā take whakatutukitanga pūtirotiro ina whakamahi i ngā " +"pātengi raraunga me ngā ripanga whānui rawa." + +msgid "Disable drill to detail" +msgstr "Whakakore i te keri ki te taipitopito" + +msgid "Disable embedding?" +msgstr "Whakakore i te tāmau?" + +msgid "Disabled" +msgstr "Kua Whakakorehia" + +msgid "Disables the drill to detail feature for this database." +msgstr "" +"Ka whakakore i te āhuatanga keri ki te taipitopito mō tēnei pātengi " +"raraunga." + +msgid "Discard" +msgstr "Whakarerea" + +msgid "Display Name" +msgstr "Ingoa Whakaatu" + +msgid "Display all" +msgstr "Whakaatu katoa" + +msgid "Display column in the chart" +msgstr "Whakaatu tīwae i te kauwhata" + +msgid "Display column level subtotal" +msgstr "Whakaatu tapeke taumata tīwae" + +msgid "Display column level total" +msgstr "Whakaatu tapeke taumata tīwae" + +msgid "Display column name" +msgstr "Whakaatu ingoa tīwae" + +msgid "Display configuration" +msgstr "Whirihora whakaatu" + +msgid "" +"Display metrics side by side within each column, as opposed to each column " +"being displayed side by side for each metric." +msgstr "" +"Whakaatu ine taha-taha i roto i ia tīwae, kaua ko ia tīwae e whakaaturia ana" +" taha-taha mō ia ine." + +msgid "" +"Display percents in the label and tooltip as the percent of the total value," +" from the first step of the funnel, or from the previous step in the funnel." +msgstr "" +"Whakaatu ōrau i te tapanga me te kītukutuku hei ōrau o te uara tapeke, mai i" +" te takahanga tuatahi o te kōrere, mai rānei i te takahanga tōmua o te " +"kōrere." + +msgid "Display row level subtotal" +msgstr "Whakaatu tapeke-iti taumata rārangi" + +msgid "Display row level total" +msgstr "Whakaatu tapeke taumata rārangi" + +msgid "Display type icon" +msgstr "Whakaatu tohu momo" + +msgid "" +"Displays connections between entities in a graph structure. Useful for " +"mapping relationships and showing which nodes are important in a network. " +"Graph charts can be configured to be force-directed or circulate. If your " +"data has a geospatial component, try the deck.gl Arc chart." +msgstr "" +"Ka whakaatu i ngā hononga i waenga i ngā pūtahi i tētahi hangahanga " +"kauwhata. He whaihua mō te whakaahua i ngā hononga me te whakaatu ko ēhea " +"ngā pona e hiranga ana i tētahi whatunga. Ka taea te whirihora i ngā " +"kauwhata kauwhata kia kaha-ākina, kia āmiomio rānei. Mēnā he waeine tauwāhi " +"tō raraunga, whakamātauhia te kauwhata Arc deck.gl." + +msgid "Distribute across" +msgstr "Tohatoha puta noa" + +msgid "Distribution" +msgstr "Tohatoha" + +msgid "Divider" +msgstr "Wehewehe" + +msgid "Do you want a donut or a pie?" +msgstr "E hiahia ana koe ki tētahi pānuki, ki tētahi pai rānei?" + +msgid "Documentation" +msgstr "Tuhinga" + +msgid "Domain" +msgstr "Rohe" + +msgid "Donut" +msgstr "Paraki" + +msgid "Dotted" +msgstr "Tongi" + +msgid "Download" +msgstr "Tikiake" + +msgid "Download as Image" +msgstr "Tikiake hei Whakaahua" + +msgid "Download as image" +msgstr "Tikiake hei whakaahua" + +msgid "Download is on the way" +msgstr "Kei te haere mai te tikiake" + +msgid "Download to CSV" +msgstr "Tikiake ki CSV" + +#, python-format +msgid "" +"Downloading %(rows)s rows based on the LIMIT configuration. If you want the " +"entire result set, you need to adjust the LIMIT." +msgstr "" +"E tikiake ana i ngā rārangi %(rows)s i runga i te whirihora LIMIT. Mēnā e " +"hiahia ana koe i te huinga hua katoa, me whakatika koe i te LIMIT." + +msgid "Draft" +msgstr "Tuhinga" + +msgid "Drag and drop components and charts to the dashboard" +msgstr "Tō-me-tuku i ngā waeine me ngā kauwhata ki te papatohu" + +msgid "Drag and drop components to this tab" +msgstr "Tō-me-tuku i ngā waeine ki tēnei ripa" + +msgid "Draw a marker on data points. Only applicable for line types." +msgstr "Tuhia he tohu i runga i ngā tohu raraunga. Mō ngā momo rārangi anake." + +msgid "Draw area under curves. Only applicable for line types." +msgstr "Tuhia te horahanga i raro i ngā kōpiko. Mō ngā momo rārangi anake." + +msgid "Draw line from Pie to label when labels outside?" +msgstr "Tuhia rārangi mai i te Pai ki te tapanga ina kei waho ngā tapanga?" + +msgid "Draw split lines for minor axis ticks" +msgstr "Tuhia rārangi wehe mō ngā tika tukutuku iti" + +msgid "Draw split lines for minor y-axis ticks" +msgstr "Tuhia rārangi wehe mō ngā tika tukutuku-y iti" + +msgid "Drill by" +msgstr "Keri mā" + +msgid "Drill by is not available for this data point" +msgstr "Karekau e wātea te keri mā mō tēnei tohu raraunga" + +msgid "Drill by is not yet supported for this chart type" +msgstr "Kāore anō kia tautokona te keri mā mō tēnei momo kauwhata" + +#, python-format +msgid "Drill by: %s" +msgstr "Keri mā: %s" + +msgid "Drill to detail" +msgstr "Keri ki te taipitopito" + +msgid "Drill to detail by" +msgstr "Keri ki te taipitopito mā" + +msgid "Drill to detail by value is not yet supported for this chart type." +msgstr "" +"Kāore anō kia tautokona te keri ki te taipitopito mā te uara mō tēnei momo " +"kauwhata." + +msgid "" +"Drill to detail is disabled because this chart does not group data by " +"dimension value." +msgstr "" +"Kua whakakorehia te keri ki te taipitopito nā te mea karekau tēnei kauwhata " +"e rōpū ana i ngā raraunga mā te uara āhuahanga." + +msgid "" +"Drill to detail is disabled for this database. Change the database settings " +"to enable it." +msgstr "" +"Kua whakakorehia te keri ki te taipitopito mō tēnei pātengi raraunga. " +"Hurihia ngā tautuhinga pātengi raraunga hei whakahohe." + +#, python-format +msgid "Drill to detail: %s" +msgstr "Keri ki te taipitopito: %s" + +msgid "Drop a column here or click" +msgid_plural "Drop columns here or click" +msgstr[0] "Taka tētahi tīwae ki konei, pāwhiri rānei" +msgstr[1] "Taka ngā tīwae ki konei, pāwhiri rānei" + +msgid "Drop a column/metric here or click" +msgid_plural "Drop columns/metrics here or click" +msgstr[0] "Taka tētahi tīwae/ine ki konei, pāwhiri rānei" +msgstr[1] "Taka ngā tīwae/ine ki konei, pāwhiri rānei" + +msgid "Drop a temporal column here or click" +msgstr "Tukua tētahi tīwae wā ki konei, pāwhiria rānei" + +msgid "Drop columns/metrics here or click" +msgstr "Tukua ngā tīwae/ine ki konei, pāwhiria rānei" + +msgid "Duplicate" +msgstr "Tārua" + +#, python-format +msgid "Duplicate column name(s): %(columns)s" +msgstr "Ingoa tīwae tārua: %(columns)s" + +#, python-format +msgid "" +"Duplicate column/metric labels: %(labels)s. Please make sure all columns and" +" metrics have a unique label." +msgstr "" +"Tapanga tīwae/ine tārua: %(labels)s. Tēnā kia mārama he tapanga ahurei tō " +"ngā tīwae me ngā ine katoa." + +msgid "Duplicate dataset" +msgstr "Tārua rārangi raraunga" + +msgid "Duplicate role" +msgstr "Tārua tūranga" + +#, python-format +msgid "Duplicate role %(name)s" +msgstr "Tārua tūranga %(name)s" + +msgid "Duplicate tab" +msgstr "Tārua ripa" + +msgid "Duration" +msgstr "Roa" + +msgid "" +"Duration (in seconds) of the caching timeout for charts of this database. A " +"timeout of 0 indicates that the cache never expires, and -1 bypasses the " +"cache. Note this defaults to the global timeout if undefined." +msgstr "" +"Roa (i ngā hēkona) o te wā kore-mahi keteroki mō ngā kauwhata o tēnei " +"pātengi raraunga. Ko te wā-pau 0 e tohu ana karekau te keteroki e pau, ā, ka" +" poke te -1 i te keteroki. Kia mōhio ka heke tēnei ki te wā-pau ao whānui " +"mēnā kāore i tautuhia." + +msgid "" +"Duration (in seconds) of the caching timeout for this chart. Set to -1 to " +"bypass the cache. Note this defaults to the dataset's timeout if undefined." +msgstr "" +"Roa (i ngā hēkona) o te wā kore-mahi keteroki mō tēnei kauwhata. Tautuhia ki" +" -1 hei poke i te keteroki. Kia mōhio ka heke tēnei ki te wā-pau o te " +"rārangi raraunga mēnā kāore i tautuhia." + +msgid "" +"Duration (in seconds) of the metadata caching timeout for schemas of this " +"database. If left unset, the cache never expires." +msgstr "" +"Roa (i ngā hēkona) o te wā kore-mahi keteroki metadata mō ngā hanga o tēnei " +"pātengi raraunga. Mēnā ka waiho kau, karekau te keteroki e pau." + +msgid "" +"Duration (in seconds) of the metadata caching timeout for tables of this " +"database. If left unset, the cache never expires. " +msgstr "" +"Roa (i ngā hēkona) o te wā kore-mahi keteroki metadata mō ngā ripanga o " +"tēnei pātengi raraunga. Mēnā ka waiho kau, karekau te keteroki e pau. " + +msgid "Duration in ms (1.40008 => 1ms 400µs 80ns)" +msgstr "Roa i ngā ms (1.40008 => 1ms 400µs 80ns)" + +msgid "Duration in ms (100.40008 => 100ms 400µs 80ns)" +msgstr "Roa i ngā ms (100.40008 => 100ms 400µs 80ns)" + +msgid "Duration in ms (10500 => 0:10.5)" +msgstr "Roa i ngā ms (10500 => 0:10.5)" + +msgid "Duration in ms (66000 => 1m 6s)" +msgstr "Roa i ngā ms (66000 => 1m 6s)" + +msgid "Dynamic Aggregation Function" +msgstr "Taumahi Whakaarotau Autōkē" + +msgid "Dynamically search all filter values" +msgstr "Rapu autōkē i ngā uara tātari katoa" + +msgid "ECharts" +msgstr "ECharts" + +msgid "EMAIL_REPORTS_CTA" +msgstr "EMAIL_REPORTS_CTA" + +msgid "END (EXCLUSIVE)" +msgstr "MUTUNGA (MOTUHAKE)" + +msgid "ERROR" +msgstr "HAPA" + +msgid "Edge length" +msgstr "Roa tapa" + +msgid "Edge length between nodes" +msgstr "Roa tapa i waenga i ngā pona" + +msgid "Edge symbols" +msgstr "Tohu tapa" + +msgid "Edge width" +msgstr "Whānui tapa" + +msgid "Edit" +msgstr "Whakatika" + +msgid "Edit Alert" +msgstr "Whakatika Matohi" + +msgid "Edit CSS" +msgstr "Whakatika CSS" + +msgid "Edit CSS template properties" +msgstr "Whakatika āhuatanga tauira CSS" + +msgid "Edit Chart Properties" +msgstr "Whakatika Āhuatanga Kauwhata" + +msgid "Edit Dashboard" +msgstr "Whakatika Papatohu" + +msgid "Edit Dataset " +msgstr "Whakatika Rārangi Raraunga " + +msgid "Edit Log" +msgstr "Whakatika Rārangi" + +msgid "Edit Plugin" +msgstr "Whakatika Mono" + +msgid "Edit Report" +msgstr "Whakatika Pūrongo" + +msgid "Edit Role" +msgstr "Whakatika Tūranga" + +msgid "Edit Rule" +msgstr "Whakatika Ture" + +msgid "Edit Tag" +msgstr "Whakatika Tohu" + +msgid "Edit User" +msgstr "Whakatika Kaiwhakamahi" + +msgid "Edit annotation" +msgstr "Whakatika tohu" + +msgid "Edit annotation layer" +msgstr "Whakatika papa tohu" + +msgid "Edit annotation layer properties" +msgstr "Whakatika āhuatanga papa tohu" + +msgid "Edit chart" +msgstr "Whakatika kauwhata" + +msgid "Edit chart properties" +msgstr "Whakatika āhuatanga kauwhata" + +msgid "Edit dashboard" +msgstr "Whakatika papatohu" + +msgid "Edit database" +msgstr "Whakatika pātengi raraunga" + +msgid "Edit dataset" +msgstr "Whakatika rārangi raraunga" + +msgid "Edit email report" +msgstr "Whakatika pūrongo īmēra" + +msgid "Edit formatter" +msgstr "Whakatika kaihōputu" + +msgid "Edit properties" +msgstr "Whakatika āhuatanga" + +msgid "Edit query" +msgstr "Whakatika pātai" + +msgid "Edit role" +msgstr "Whakatika tūranga" + +msgid "Edit template" +msgstr "Whakatika tauira" + +msgid "Edit template parameters" +msgstr "Whakatika tawhā tauira" + +msgid "Edit the dashboard" +msgstr "Whakatika te papatohu" + +msgid "Edit time range" +msgstr "Whakatika awhe wā" + +msgid "Edit user" +msgstr "Whakatika kaiwhakamahi" + +msgid "Edited" +msgstr "Kua Whakatikahia" + +msgid "Editing 1 filter:" +msgstr "E whakatika ana i te 1 tātari:" + +msgid "Either the database is spelled incorrectly or does not exist." +msgstr "Kua hē te pūwaea o te pātengi raraunga, karekau pea rānei." + +#, python-format +msgid "Either the username \"%(username)s\" or the password is incorrect." +msgstr "Kua hē te ingoa kaiwhakamahi \"%(username)s\", te kupuhipa rānei." + +#, python-format +msgid "" +"Either the username \"%(username)s\", password, or database name " +"\"%(database)s\" is incorrect." +msgstr "" +"Kua hē te ingoa kaiwhakamahi \"%(username)s\", te kupuhipa rānei, te ingoa " +"pātengi raraunga \"%(database)s\" rānei." + +msgid "Either the username or the password is wrong." +msgstr "Kua hē te ingoa kaiwhakamahi, te kupuhipa rānei." + +msgid "Elevation" +msgstr "Teiteitanga" + +msgid "Email" +msgstr "Īmēra" + +msgid "Email is required" +msgstr "E hiahiatia ana he īmēra" + +msgid "Email reports active" +msgstr "Pūrongo īmēra hohe" + +msgid "Email subject name (optional)" +msgstr "Ingoa kaupapa īmēra (kōwhiringa)" + +msgid "Embed" +msgstr "Tāmau" + +msgid "Embed code" +msgstr "Waehere tāmau" + +msgid "Embed dashboard" +msgstr "Tāmau papatohu" + +msgid "Embedded dashboard could not be deleted." +msgstr "Kāore i taea te muku i te papatohu tāmau." + +msgid "Embedding deactivated." +msgstr "Tāmau kua whakakore." + +msgid "Emit Filter Events" +msgstr "Tuku Kaupapa Tātari" + +msgid "Emphasis" +msgstr "Whakatoi" + +msgid "Empty circle" +msgstr "Porohita kau" + +msgid "Empty collection" +msgstr "Kohinga kau" + +msgid "Empty column" +msgstr "Tīwae kau" + +msgid "Empty query result" +msgstr "Hua pātai kau" + +msgid "Empty query?" +msgstr "Pātai kau?" + +msgid "Empty row" +msgstr "Rārangi kau" + +msgid "Enable 'Allow file uploads to database' in any database's settings" +msgstr "" +"Whakahohe 'Whakāetia ngā tukuake kōnae ki te pātengi raraunga' i ngā " +"tautuhinga o tētahi pātengi raraunga" + +msgid "Enable cross-filtering" +msgstr "Whakahohe tātari-whiti" + +msgid "Enable data zooming controls" +msgstr "Whakahohe whakahaere topa raraunga" + +msgid "Enable embedding" +msgstr "Whakahohe tāmau" + +msgid "Enable forecast" +msgstr "Whakahohe matapae" + +msgid "Enable forecasting" +msgstr "Whakahohe matapae" + +msgid "Enable graph roaming" +msgstr "Whakahohe kauwhata takahuri" + +msgid "Enable node dragging" +msgstr "Whakahohe pona tō" + +msgid "Enable query cost estimation" +msgstr "Whakahohe tauwhitinga utu pātai" + +msgid "Enable row expansion in schemas" +msgstr "Whakahohe whakawhānuitanga rārangi i ngā hanga" + +msgid "Enable server side pagination of results (experimental feature)" +msgstr "Whakahohe whārangitanga taha-tūmau o ngā hua (āhuatanga whakamātau)" + +msgid "" +"Encountered invalid NULL spatial entry," +" please consider filtering those out" +msgstr "" +"I tūtaki urunga tauwāhi NULL muhu, " +"tēnā whiriārohia te tātari i aua" + +msgid "End" +msgstr "Mutunga" + +msgid "End (Longitude, Latitude): " +msgstr "Mutunga (Longitude, Latitude): " + +msgid "End Longitude & Latitude" +msgstr "Longitude me Latitude Mutunga" + +msgid "End angle" +msgstr "Koki mutunga" + +msgid "End date" +msgstr "Rā mutunga" + +msgid "End date excluded from time range" +msgstr "Rā mutunga kua whakakorehia mai i te awhe wā" + +msgid "End date must be after start date" +msgstr "Me muri te rā mutunga i te rā tīmata" + +#, python-format +msgid "Engine \"%(engine)s\" cannot be configured through parameters." +msgstr "Kāore e taea te whirihora i te pūkaha \"%(engine)s\" mā ngā tawhā." + +msgid "Engine Parameters" +msgstr "Tawhā Pūkaha" + +msgid "" +"Engine spec \"InvalidEngine\" does not support being configured via " +"individual parameters." +msgstr "" +"Karekau te tohu pūkaha \"InvalidEngine\" e tautoko i te whirihorahia mā ngā " +"tawhā takitahi." + +msgid "Enter CA_BUNDLE" +msgstr "Tāuru CA_BUNDLE" + +msgid "Enter Primary Credentials" +msgstr "Tāuru Taipitopito Matua" + +msgid "Enter a name for this sheet" +msgstr "Tāuru ingoa mō tēnei hīti" + +msgid "Enter a new title for the tab" +msgstr "Tāuru taitara hou mō te ripa" + +msgid "Enter alert name" +msgstr "Tāuru ingoa matohi" + +msgid "Enter duration in seconds" +msgstr "Tāuru roa i ngā hēkona" + +msgid "Enter fullscreen" +msgstr "Uru mata katoa" + +msgid "Enter report name" +msgstr "Tāuru ingoa pūrongo" + +#, python-format +msgid "Enter the required %(dbModelName)s credentials" +msgstr "Tāuru i ngā taipitopito %(dbModelName)s e hiahiatia ana" + +msgid "Enter the unique project id for your database." +msgstr "Tāuru i te id kaupapa ahurei mō tō pātengi raraunga." + +msgid "Enter the user's email" +msgstr "Tāuru i te īmēra o te kaiwhakamahi" + +msgid "Enter the user's first name" +msgstr "Tāuru i te ingoa tuatahi o te kaiwhakamahi" + +msgid "Enter the user's last name" +msgstr "Tāuru i te ingoa whakamutunga o te kaiwhakamahi" + +msgid "Enter the user's username" +msgstr "Tāuru i te ingoa kaiwhakamahi o te kaiwhakamahi" + +msgid "Entity" +msgstr "Pūtahi" + +msgid "Equal Date Sizes" +msgstr "Rahi Rā Ōrite" + +msgid "Equal to (=)" +msgstr "Ōrite ki (=)" + +msgid "Error" +msgstr "Hapa" + +msgid "Error Fetching Tagged Objects" +msgstr "Hapa i te Tikitanga o ngā Ahanoa Kua Tohuhia" + +#, python-format +msgid "Error deleting %s" +msgstr "Hapa i te mukutanga o %s" + +msgid "Error faving chart" +msgstr "Hapa i te whakamakauhia i te kauwhata" + +#, python-format +msgid "Error in jinja expression in HAVING clause: %(msg)s" +msgstr "Hapa i te kīanga jinja i te rerenga HAVING: %(msg)s" + +#, python-format +msgid "Error in jinja expression in RLS filters: %(msg)s" +msgstr "Hapa i te kīanga jinja i ngā tātari RLS: %(msg)s" + +#, python-format +msgid "Error in jinja expression in WHERE clause: %(msg)s" +msgstr "Hapa i te kīanga jinja i te rerenga WHERE: %(msg)s" + +#, python-format +msgid "Error in jinja expression in fetch values predicate: %(msg)s" +msgstr "Hapa i te kīanga jinja i te tohu tiki uara: %(msg)s" + +msgid "Error loading chart datasources. Filters may not work correctly." +msgstr "" +"Hapa i te utanga o ngā puna raraunga kauwhata. Ka kore pea e mahi tika ngā " +"tātari." + +msgid "Error message" +msgstr "Karere hapa" + +msgid "Error parsing" +msgstr "Hapa poroporo" + +msgid "Error reading CSV file" +msgstr "Hapa i te pānuitanga o te kōnae CSV" + +msgid "Error reading Columnar file" +msgstr "Hapa i te pānuitanga o te kōnae Tīwae Pou" + +msgid "Error reading Excel file" +msgstr "Hapa i te pānuitanga o te kōnae Excel" + +msgid "Error saving dataset" +msgstr "Hapa i te tiakitanga o te rārangi raraunga" + +msgid "Error unfaving chart" +msgstr "Hapa i te kore-whakamakauhia i te kauwhata" + +msgid "Error while adding role!" +msgstr "Hapa i te tāpiritanga o te tūranga!" + +msgid "Error while adding user!" +msgstr "Hapa i te tāpiritanga o te kaiwhakamahi!" + +msgid "Error while duplicating role!" +msgstr "Hapa i te tāruatanga o te tūranga!" + +msgid "Error while fetching charts" +msgstr "Hapa i te tikitanga o ngā kauwhata" + +#, python-format +msgid "Error while fetching data: %s" +msgstr "Hapa i te tikitanga o ngā raraunga: %s" + +msgid "Error while fetching permissions" +msgstr "Hapa i te tikitanga o ngā mōtika" + +msgid "Error while fetching roles" +msgstr "Hapa i te tikitanga o ngā tūranga" + +msgid "Error while fetching users" +msgstr "Hapa i te tikitanga o ngā kaiwhakamahi" + +#, python-format +msgid "Error while rendering virtual dataset query: %(msg)s" +msgstr "Hapa i te whakaatutanga o te pātai rārangi raraunga mariko: %(msg)s" + +msgid "Error while updating role!" +msgstr "Hapa i te whakahouhanga o te tūranga!" + +msgid "Error while updating user!" +msgstr "Hapa i te whakahouhanga o te kaiwhakamahi!" + +#, python-format +msgid "Error: %(error)s" +msgstr "Hapa: %(error)s" + +#, python-format +msgid "Error: %(msg)s" +msgstr "Hapa: %(msg)s" + +msgid "Error: permalink state not found" +msgstr "Hapa: kāore i kitea te tūnga hononga-ā-mau" + +msgid "Estimate cost" +msgstr "Tauwhitinga utu" + +msgid "Estimate selected query cost" +msgstr "Tauwhitinga utu pātai kua tīpakohia" + +msgid "Estimate the cost before running a query" +msgstr "Tauwhitinga te utu i mua i te whakahaere i tētahi pātai" + +msgid "Event" +msgstr "Kaupapa" + +msgid "Event flow" +msgstr "Rere kaupapa" + +msgid "Event time column" +msgstr "Tīwae wā kaupapa" + +msgid "Every" +msgstr "Ia" + +msgid "Evolution" +msgstr "Whanaketanga" + +msgid "Exact" +msgstr "Tika" + +msgid "Example" +msgstr "Tauira" + +msgid "Examples" +msgstr "Tauira" + +msgid "Excel file format cannot be determined" +msgstr "Kāore e taea te whakatau i te hōputu kōnae Excel" + +msgid "Excel upload" +msgstr "Tukuake Excel" + +msgid "Exclude selected values" +msgstr "Whakakorehia ngā uara kua tīpakohia" + +msgid "Excluded roles" +msgstr "Tūranga kua whakakorehia" + +msgid "Executed SQL" +msgstr "SQL kua whakatutukia" + +msgid "Executed query" +msgstr "Pātai kua whakatutukia" + +msgid "Execution ID" +msgstr "ID Whakatutuki" + +msgid "Execution log" +msgstr "Rārangi whakatutuki" + +msgid "Existing dataset" +msgstr "Rārangi raraunga kei te tīari" + +msgid "Exit fullscreen" +msgstr "Puta i te mata-katoa" + +msgid "Expand" +msgstr "Whakawhānui" + +msgid "Expand all" +msgstr "Whakawhānui katoa" + +msgid "Expand data panel" +msgstr "Whakawhānui papa raraunga" + +msgid "Expand row" +msgstr "Whakawhānui rārangi" + +msgid "Expand table preview" +msgstr "Whakawhānui arokite ripanga" + +msgid "Expand tool bar" +msgstr "Whakawhānui pae taputapu" + +msgid "" +"Expects a formula with depending time parameter 'x'\n" +" in milliseconds since epoch. mathjs is used to evaluate the formulas.\n" +" Example: '2x+5'" +msgstr "E tūmanako ana i tētahi tauira me te tawhā wā whakawhirinaki 'x'" + +msgid "Experimental" +msgstr "Whakamātautau" + +msgid "Explore" +msgstr "Tūhura" + +#, python-format +msgid "Explore - %(table)s" +msgstr "Tūhura - %(table)s" + +msgid "Explore the result set in the data exploration view" +msgstr "Tūhuratia te huinga hua i te tirohanga tūhuratanga raraunga" + +msgid "Export" +msgstr "Kaweatu" + +msgid "Export dashboards?" +msgstr "Kaweatu papatohu?" + +msgid "Export query" +msgstr "Kaweatu pātai" + +msgid "Export to .CSV" +msgstr "Kaweatu ki .CSV" + +msgid "Export to .JSON" +msgstr "Kaweatu ki .JSON" + +msgid "Export to Excel" +msgstr "Kaweatu ki Excel" + +msgid "Export to PDF" +msgstr "Kaweatu ki PDF" + +msgid "Export to Pivoted .CSV" +msgstr "Kaweatu ki .CSV Hurihuri" + +msgid "Export to full .CSV" +msgstr "Kaweatu ki .CSV katoa" + +msgid "Export to full Excel" +msgstr "Kaweatu ki Excel katoa" + +msgid "Export to original .CSV" +msgstr "Kaweatu ki .CSV taketake" + +msgid "Export to pivoted .CSV" +msgstr "Kaweatu ki .CSV hurihuri" + +msgid "Expose database in SQL Lab" +msgstr "Whakaaturia te pātengi raraunga i SQL Lab" + +msgid "Expose in SQL Lab" +msgstr "Whakaaturia i SQL Lab" + +msgid "Extent" +msgstr "Whānuitanga" + +msgid "Extra" +msgstr "Taapiri" + +msgid "Extra Controls" +msgstr "Whakahaere Taapiri" + +msgid "Extra Parameters" +msgstr "Tawhā Taapiri" + +msgid "Extra data for JS" +msgstr "Raraunga taapiri mō JS" + +msgid "" +"Extra data to specify table metadata. Currently supports metadata of the " +"format: `{ \"certification\": { \"certified_by\": \"Data Platform Team\", " +"\"details\": \"This table is the source of truth.\" }, \"warning_markdown\":" +" \"This is a warning.\" }`." +msgstr "" +"Raraunga taapiri hei tohu i te metadata ripanga. I tēnei wā ka tautoko i te " +"metadata o te hōputu: `{ \"certification\": { \"certified_by\": \"Data " +"Platform Team\", \"details\": \"This table is the source of truth.\" }, " +"\"warning_markdown\": \"This is a warning.\" }`." + +msgid "Extra parameters for use in jinja templated queries" +msgstr "Tawhā taapiri mō te whakamahi i ngā pātai tauira jinja" + +msgid "" +"Extra parameters that any plugins can choose to set for use in Jinja " +"templated queries" +msgstr "" +"Tawhā taapiri ka taea e ngā mono katoa te kōwhiri ki te tautuhi mō te " +"whakamahi i ngā pātai tauira Jinja" + +msgid "Extra url parameters for use in Jinja templated queries" +msgstr "Tawhā url taapiri mō te whakamahi i ngā pātai tauira Jinja" + +msgid "Extruded" +msgstr "Kua whakaputaina" + +msgid "FEB" +msgstr "HUI" + +msgid "FIT DATA" +msgstr "WHAKAHĀNGAI RARAUNGA" + +msgid "FRI" +msgstr "PAR" + +msgid "Factor" +msgstr "Pūwehe" + +msgid "Factor to multiply the metric by" +msgstr "Pūwehe hei whakarea i te ine" + +msgid "Fail login count" +msgstr "Tatau takiuru rahua" + +msgid "Failed" +msgstr "I Rahua" + +msgid "Failed at retrieving results" +msgstr "I rahua te tiki i ngā hua" + +msgid "Failed to create report" +msgstr "I rahua te hanga i te pūrongo" + +#, python-format +msgid "Failed to execute %(query)s" +msgstr "I rahua te whakatutuki i %(query)s" + +msgid "Failed to generate chart edit URL" +msgstr "I rahua te hanga i te URL whakatika kauwhata" + +msgid "Failed to load chart data" +msgstr "I rahua te uta i ngā raraunga kauwhata" + +msgid "Failed to load chart data." +msgstr "I rahua te uta i ngā raraunga kauwhata." + +msgid "Failed to load dimensions for drill by" +msgstr "I rahua te uta i ngā āhuahanga mō te keri mā" + +msgid "Failed to retrieve advanced type" +msgstr "I rahua te tiki i te momo aromatawai" + +msgid "Failed to save cross-filter scoping" +msgstr "I rahua te tiaki i te korahi tātari-whiti" + +msgid "Failed to start remote query on a worker." +msgstr "I rahua te tīmata i te pātai tawhiti i runga i tētahi kaimahi." + +msgid "Failed to stop query." +msgstr "I rahua te whakamutua i te pātai." + +msgid "Failed to tag items" +msgstr "I rahua te tohu i ngā mea" + +msgid "Failed to update report" +msgstr "I rahua te whakahou i te pūrongo" + +#, python-format +msgid "Failed to verify select options: %s" +msgstr "I rahua te manatoko i ngā kōwhiringa tīpako: %s" + +msgid "Favorite" +msgstr "Makau" + +msgid "Featured" +msgstr "Whakaaturia" + +msgid "Featured color palettes" +msgstr "Paka tae whakaaturia" + +msgid "February" +msgstr "Huitanguru" + +msgid "Fetch data preview" +msgstr "Tiki arokite raraunga" + +#, python-format +msgid "Fetched %s" +msgstr "Kua tikihia %s" + +msgid "Fetching" +msgstr "E tiki ana" + +#, python-format +msgid "Field cannot be decoded by JSON. %(json_error)s" +msgstr "Kāore e taea te whakaoti i te āpure mā te JSON. %(json_error)s" + +#, python-format +msgid "Field cannot be decoded by JSON. %(msg)s" +msgstr "Kāore e taea te whakaoti i te āpure mā te JSON. %(msg)s" + +msgid "Field is required" +msgstr "E hiahiatia ana te āpure" + +msgid "File" +msgstr "Kōnae" + +msgid "File extension is not allowed." +msgstr "Karekau e whakāetia te toronga kōnae." + +msgid "File settings" +msgstr "Tautuhinga kōnae" + +msgid "File upload" +msgstr "Tukuake kōnae" + +msgid "Fill Color" +msgstr "Tae Whakakī" + +msgid "Fill all required fields to enable \"Default Value\"" +msgstr "" +"Whakakīa ngā āpure katoa e hiahiatia ana hei whakahohe i te \"Uara Taunoa\"" + +msgid "Fill method" +msgstr "Tikanga whakakī" + +msgid "Filled" +msgstr "Kua whakakīa" + +msgid "Filter" +msgstr "Tātari" + +msgid "Filter Configuration" +msgstr "Whirihora Tātari" + +msgid "Filter List" +msgstr "Rārangi Tātari" + +msgid "Filter Settings" +msgstr "Tautuhinga Tātari" + +msgid "Filter Type" +msgstr "Momo Tātari" + +msgid "Filter charts" +msgstr "Tātari kauwhata" + +msgid "Filter has default value" +msgstr "He uara taunoa tō te tātari" + +msgid "Filter menu" +msgstr "Tahua tātari" + +msgid "Filter name" +msgstr "Ingoa tātari" + +msgid "" +"Filter only displays values relevant to selections made in other filters." +msgstr "" +"Ka whakaatu anake te tātari i ngā uara hāngai ki ngā tīpakonga kua mahia i " +"ētahi atu tātari." + +msgid "Filter results" +msgstr "Tātari hua" + +msgid "Filter type" +msgstr "Momo tātari" + +msgid "Filter value (case sensitive)" +msgstr "Uara tātari (aro reta iti/nui)" + +msgid "Filter value is required" +msgstr "E hiahiatia ana te uara tātari" + +msgid "Filter value list cannot be empty" +msgstr "Kāore e taea te noho kau te rārangi uara tātari" + +msgid "Filter your charts" +msgstr "Tātari i ō kauwhata" + +msgid "Filters" +msgstr "Tātari" + +msgid "Filters by columns" +msgstr "Tātari mā ngā tīwae" + +msgid "Filters by metrics" +msgstr "Tātari mā ngā ine" + +msgid "Filters for comparison must have a value" +msgstr "Me whai uara ngā tātari mō te whakatairite" + +msgid "Filters for values equal to this exact value." +msgstr "Tātari mō ngā uara e ōrite ana ki tēnei uara tonu." + +msgid "Filters for values greater than or equal." +msgstr "Tātari mō ngā uara nui ake, ōrite rānei." + +msgid "Filters for values less than or equal." +msgstr "Tātari mō ngā uara iti ake, ōrite rānei." + +#, python-format +msgid "Filters out of scope (%d)" +msgstr "Tātari i waho o te korahi (%d)" + +msgid "" +"Filters with the same group key will be ORed together within the group, " +"while different filter groups will be ANDed together. Undefined group keys " +"are treated as unique groups, i.e. are not grouped together. For example, if" +" a table has three filters, of which two are for departments Finance and " +"Marketing (group key = 'department'), and one refers to the region Europe " +"(group key = 'region'), the filter clause would apply the filter (department" +" = 'Finance' OR department = 'Marketing') AND (region = 'Europe')." +msgstr "" +"Ka whakakotahi ngā tātari me te kī rōpū ōrite mā te OR i roto i te rōpū, " +"engari ka whakakotahi ngā rōpū tātari rerekē mā te AND. Ka whakahaere i ngā " +"kī rōpū kāore i tautuhia hei rōpū ahurei, arā karekau e rōpūngia. Hei " +"tauira, mēnā he toru ngā tātari o tētahi ripanga, ko ētahi e rua mō ngā tari" +" Pūtea me Hokohoko (kī rōpū = 'tari'), ā, ko tētahi e tohu ana ki te rohe " +"Ūropi (kī rōpū = 'rohe'), ka whakahaeretia e te rerenga tātari te tātari " +"(tari = 'Pūtea' OR tari = 'Hokohoko') AND (rohe = 'Ūropi')." + +msgid "Find" +msgstr "Kimi" + +msgid "Finish" +msgstr "Whakaoti" + +msgid "First" +msgstr "Tuatahi" + +msgid "First name" +msgstr "Ingoa tuatahi" + +msgid "First name is required" +msgstr "E hiahiatia ana te ingoa tuatahi" + +msgid "" +"Fix the trend line to the full time range specified in case filtered results" +" do not include the start or end dates" +msgstr "" +"Whakatikahia te rārangi ia ki te awhe wā katoa kua tohua mēnā karekau ngā " +"hua kua tātaritia e whai ana i ngā rā tīmatanga, mutunga rānei" + +msgid "Fix to selected Time Range" +msgstr "Whakatikahia ki te Awhe Wā kua tīpakohia" + +msgid "Fixed" +msgstr "Kua Whakatikahia" + +msgid "Fixed Color" +msgstr "Tae Mau" + +msgid "Fixed color" +msgstr "Tae mau" + +msgid "Fixed point radius" +msgstr "Pūtoro tohu mau" + +msgid "Flow" +msgstr "Rere" + +msgid "Font size" +msgstr "Rahi momotuhi" + +msgid "Font size for axis labels, detail value and other text elements" +msgstr "" +"Rahi momotuhi mō ngā tapanga tukutuku, uara taipitopito me ētahi atu huānga " +"kupu" + +msgid "Font size for the biggest value in the list" +msgstr "Rahi momotuhi mō te uara nui rawa i te rārangi" + +msgid "Font size for the smallest value in the list" +msgstr "Rahi momotuhi mō te uara iti rawa i te rārangi" + +msgid "" +"For Bigquery, Presto and Postgres, shows a button to compute cost before " +"running a query." +msgstr "" +"Mō Bigquery, Presto me Postgres, ka whakaatu i tētahi pātene hei tatau i te " +"utu i mua i te whakahaere i tētahi pātai." + +msgid "" +"For Trino, describe full schemas of nested ROW types, expanding them with " +"dotted paths" +msgstr "" +"Mō Trino, whakamāramahia ngā hanga katoa o ngā momo ROW whakawhāiti, ka " +"whakawhānuitia ki ngā ara tongi" + +msgid "For further instructions, consult the" +msgstr "Mō ētahi tohutohu atu, tirohia te" + +msgid "" +"For more information about objects are in context in the scope of this " +"function, refer to the" +msgstr "" +"Mō ētahi mōhiohio atu mō ngā ahanoa kei roto i te horopaki i te korahi o " +"tēnei taumahi, tirohia te" + +msgid "" +"For regular filters, these are the roles this filter will be applied to. For" +" base filters, these are the roles that the filter DOES NOT apply to, e.g. " +"Admin if admin should see all data." +msgstr "" +"Mō ngā tātari auau, ko ēnei ngā tūranga ka whakahaeretia ki reira tēnei " +"tātari. Mō ngā tātari pūtake, ko ēnei ngā tūranga KAREKAU e pā ana te " +"tātari, hei tauira ko te Admin mēnā me kite te Admin i ngā raraunga katoa." + +msgid "Force" +msgstr "Kaha" + +msgid "" +"Force all tables and views to be created in this schema when clicking CTAS " +"or CVAS in SQL Lab." +msgstr "" +"Akingia ngā ripanga me ngā tirohanga katoa kia hangaia ki roto i tēnei hanga" +" ina pāwhiria te CTAS, te CVAS rānei i SQL Lab." + +msgid "Force categorical" +msgstr "Akingia kāwai" + +msgid "Force date format" +msgstr "Akingia hōputu rā" + +msgid "Force refresh" +msgstr "Whakahou-ā-kaha" + +msgid "Force refresh Slack channels list" +msgstr "Whakahou-ā-kaha i te rārangi hongere Slack" + +msgid "Force refresh catalog list" +msgstr "Whakahou-ā-kaha i te rārangi kātaloka" + +msgid "Force refresh schema list" +msgstr "Whakahou-ā-kaha i te rārangi hanga" + +msgid "Force refresh table list" +msgstr "Whakahou-ā-kaha i te rārangi ripanga" + +msgid "Forecast periods" +msgstr "Wā matapae" + +msgid "Foreign key" +msgstr "Kī tāwāhi" + +msgid "Forest Green" +msgstr "Kākāriki Ngahere" + +msgid "Form data not found in cache, reverting to chart metadata." +msgstr "" +"Kāore i kitea ngā raraunga puka i te keteroki, e hoki ana ki te metadata " +"kauwhata." + +msgid "Form data not found in cache, reverting to dataset metadata." +msgstr "" +"Kāore i kitea ngā raraunga puka i te keteroki, e hoki ana ki te metadata " +"rārangi raraunga." + +msgid "Format SQL" +msgstr "Hōputu SQL" + +msgid "" +"Format data labels. Use variables: {name}, {value}, {percent}. \\n represents a new line. ECharts compatibility:\n" +"{a} (series), {b} (name), {c} (value), {d} (percentage)" +msgstr "" +"Hōputu tapanga raraunga. Whakamahia ngā taurangi: {name}, {value}, {percent}. \n" +" e tohu ana i tētahi rārangi hou. Hāngaitanga ECharts:" + +msgid "Formatted CSV attached in email" +msgstr "CSV kua hōputuhia kua tāpiritia ki te īmēra" + +msgid "Formatted date" +msgstr "Rā kua hōputuhia" + +msgid "Formatted value" +msgstr "Uara kua hōputuhia" + +msgid "Formatting" +msgstr "Hōputu" + +msgid "Formula" +msgstr "Tauira" + +msgid "Forward values" +msgstr "Uara whakamua" + +msgid "Found invalid orderby options" +msgstr "I kitea he kōwhiringa orderby muhu" + +msgid "Fraction digits" +msgstr "Mati hautanga" + +msgid "Frequency" +msgstr "Auau" + +msgid "Friction" +msgstr "Waku" + +msgid "Friction between nodes" +msgstr "Waku i waenga i ngā pona" + +msgid "Friday" +msgstr "Paraire" + +msgid "From date cannot be larger than to date" +msgstr "Kāore e taea e te rā mai te rahi ake i te rā ki" + +msgid "Full name" +msgstr "Ingoa katoa" + +msgid "Funnel Chart" +msgstr "Kauwhata Kōrere" + +msgid "Further customize how to display each column" +msgstr "Whakarerekē atu me pēhea te whakaatu i ia tīwae" + +msgid "Further customize how to display each metric" +msgstr "Whakarerekē atu me pēhea te whakaatu i ia ine" + +msgid "GROUP BY" +msgstr "RŌPŪ MĀ" + +msgid "Gauge Chart" +msgstr "Kauwhata Ine" + +msgid "General" +msgstr "Whānui" + +msgid "General information" +msgstr "Mōhiohio whānui" + +msgid "Generating link, please wait.." +msgstr "E hanga hono ana, tēnā taihoa.." + +msgid "Generic Chart" +msgstr "Kauwhata Whānui" + +msgid "Geo" +msgstr "Takiwā" + +msgid "GeoJson Column" +msgstr "Tīwae GeoJson" + +msgid "GeoJson Settings" +msgstr "Tautuhinga GeoJson" + +msgid "Geohash" +msgstr "Geohash" + +msgid "Geometry Column" +msgstr "Tīwae Āhuahanga" + +msgid "Get the last date by the date unit." +msgstr "Tikina te rā whakamutunga mā te waeine rā." + +msgid "Get the specify date for the holiday" +msgstr "Tikina te rā motuhake mō te hararei" + +msgid "Give access to multiple catalogs in a single database connection." +msgstr "" +"Tuku urunga ki ngā kātaloka maha i roto i tētahi hononga pātengi raraunga " +"kotahi." + +msgid "Go to the edit mode to configure the dashboard and add charts" +msgstr "" +"Haere ki te aratau whakatika hei whirihora i te papatohu me te tāpiri i ngā " +"kauwhata" + +msgid "Gold" +msgstr "Koura" + +msgid "Google Sheet Name and URL" +msgstr "Ingoa me te URL Google Sheet" + +msgid "Grace period" +msgstr "Wā aroha" + +msgid "Graph Chart" +msgstr "Kauwhata Kauwhata" + +msgid "Graph layout" +msgstr "Hoahoa kauwhata" + +msgid "Gravity" +msgstr "Tōpāpaku" + +msgid "Greater or equal (>=)" +msgstr "Nui ake, ōrite rānei (>=)" + +msgid "Greater than (>)" +msgstr "Nui ake (>)" + +msgid "Green for increase, red for decrease" +msgstr "Kākāriki mō te piki, whero mō te heke" + +msgid "Grid" +msgstr "Tukutata" + +msgid "Grid Size" +msgstr "Rahi Tukutata" + +msgid "Group By" +msgstr "Rōpū Mā" + +msgid "Group By, Metrics or Percentage Metrics must have a value" +msgstr "Me whai uara te Rōpū Mā, Ine, Ine Ōrau rānei" + +msgid "Group Key" +msgstr "Kī Rōpū" + +msgid "Group by" +msgstr "Rōpū mā" + +msgid "Guest user cannot modify chart payload" +msgstr "" +"Kāore e taea e te kaiwhakamahi manuhiri te whakarereke i te uta kauwhata" + +msgid "HOUR" +msgstr "HĀORA" + +msgid "Handlebars" +msgstr "Handlebars" + +msgid "Handlebars Template" +msgstr "Tauira Handlebars" + +msgid "Hard value bounds applied for color coding." +msgstr "Kua whakahaeretia ngā rohe uara mārō mō te whakakohu tae." + +msgid "Has created by" +msgstr "Kua hangaia e" + +msgid "Header" +msgstr "Pane" + +msgid "Header row" +msgstr "Rārangi pane" + +msgid "Heatmap" +msgstr "Mahere Wera" + +msgid "Height" +msgstr "Teitei" + +msgid "Height of the sparkline" +msgstr "Teitei o te rārangi kōhā" + +msgid "Hide Column" +msgstr "Huna Tīwae" + +msgid "Hide Line" +msgstr "Huna Rārangi" + +msgid "Hide chart description" +msgstr "Huna whakamārama kauwhata" + +msgid "Hide layer" +msgstr "Huna papa" + +msgid "Hide password." +msgstr "Huna kupuhipa." + +msgid "Hide tool bar" +msgstr "Huna pae taputapu" + +msgid "Hides the Line for the time series" +msgstr "Ka hunaia te Rārangi mō te raupapa wā" + +msgid "Hierarchy" +msgstr "Taumata" + +msgid "Histogram" +msgstr "Kauwhata Auau" + +msgid "Home" +msgstr "Kāinga" + +msgid "Horizon Chart" +msgstr "Kauwhata Pae Rangi" + +msgid "Horizon Charts" +msgstr "Kauwhata Pae Rangi" + +msgid "Horizontal" +msgstr "Whakapae" + +msgid "Horizontal (Top)" +msgstr "Whakapae (Runga)" + +msgid "Horizontal alignment" +msgstr "Whakarite whakapae" + +msgid "Host" +msgstr "Tūmau" + +msgid "Hostname or IP address" +msgstr "Ingoa tūmau, wāhitau IP rānei" + +msgid "Hour" +msgstr "Hāora" + +#, python-format +msgid "Hours %s" +msgstr "Hāora %s" + +msgid "Hours offset" +msgstr "Tahapa hāora" + +msgid "How do you want to enter service account credentials?" +msgstr "Me pēhea koe ki te tomo i ngā taipitopito kaute ratonga?" + +msgid "How many buckets should the data be grouped in." +msgstr "Kia hia ngā peeke me rōpū ai ngā raraunga." + +msgid "How many periods into the future do we want to predict" +msgstr "Kia hia ngā wā ki mua e hiahia ana tātou ki te matapae" + +msgid "" +"How to display time shifts: as individual lines; as the difference between " +"the main time series and each time shift; as the percentage change; or as " +"the ratio between series and time shifts." +msgstr "" +"Me pēhea te whakaatu i ngā neke wā: hei rārangi takitahi; hei rerekētanga i " +"waenga i te raupapa wā matua me ia neke wā; hei panoni ōrau; hei ōwehenga " +"rānei i waenga i ngā raupapa me ngā neke wā." + +msgid "Huge" +msgstr "Nui rawa" + +msgid "ISO 3166-2 Codes" +msgstr "Waehere ISO 3166-2" + +msgid "ISO 8601" +msgstr "ISO 8601" + +msgid "Id" +msgstr "Id" + +msgid "Id of root node of the tree." +msgstr "Id o te pona pākiaka o te rākau." + +msgid "" +"If Presto or Trino, all the queries in SQL Lab are going to be executed as " +"the currently logged on user who must have permission to run them. If Hive " +"and hive.server2.enable.doAs is enabled, will run the queries as service " +"account, but impersonate the currently logged on user via " +"hive.server2.proxy.user property." +msgstr "" +"Mēnā ko Presto, ko Trino rānei, ka whakatutukia ngā pātai katoa i SQL Lab " +"hei kaiwhakamahi kua takiuru e hiahia ana kia whai mana ia ki te whakahaere." +" Mēnā ko Hive, ā, kua whakahohengia te hive.server2.enable.doAs, ka " +"whakahaere i ngā pātai hei kaute ratonga, engari ka whakaataata i te " +"kaiwhakamahi kua takiuru mā te āhuatanga hive.server2.proxy.user." + +msgid "" +"If a metric is specified, sorting will be done based on the metric value" +msgstr "Mēnā kua tohua tētahi ine, ka mahia te kōmaka i runga i te uara ine" + +msgid "" +"If changes are made to your SQL query, columns in your dataset will be " +"synced when saving the dataset." +msgstr "" +"Mēnā ka mahia ngā huringa ki tō pātai SQL, ka hāngaitia ngā tīwae i roto i " +"tō rārangi raraunga ina tiakina te rārangi raraunga." + +msgid "" +"If enabled, this control sorts the results/values descending, otherwise it " +"sorts the results ascending." +msgstr "" +"Mēnā kua whakahohengia, ka kōmaka tēnei whakahaere i ngā hua/uara heke, ki " +"te kore ka kōmaka i ngā hua piki." + +msgid "If table already exists" +msgstr "Mēnā kei te tīari kē te ripanga" + +msgid "Ignore cache when generating report" +msgstr "Whakakorehia te keteroki ina hanga pūrongo" + +msgid "Ignore null locations" +msgstr "Whakakorehia ngā wāhi kore" + +msgid "Ignore time" +msgstr "Whakakorehia te wā" + +msgid "Image (PNG) embedded in email" +msgstr "Whakaahua (PNG) tāmautia i te īmēra" + +msgid "Image download failed, please refresh and try again." +msgstr "I rahua te tikiake whakaahua, tēnā whakahouhia, ā, whakamātauhia anō." + +msgid "" +"Impersonate logged in user (Presto, Trino, Drill, Hive, and Google Sheets)" +msgstr "" +"Whakaataata i te kaiwhakamahi kua takiuru (Presto, Trino, Drill, Hive, me " +"Google Sheets)" + +msgid "Import" +msgstr "Kawemai" + +#, python-format +msgid "Import %s" +msgstr "Kawemai %s" + +msgid "Import Dashboard(s)" +msgstr "Kawemai Papatohu" + +msgid "Import chart failed for an unknown reason" +msgstr "I rahua te kawemai kauwhata mō tētahi take kāore e mōhiotia ana" + +msgid "Import charts" +msgstr "Kawemai kauwhata" + +msgid "Import dashboard failed for an unknown reason" +msgstr "I rahua te kawemai papatohu mō tētahi take kāore e mōhiotia ana" + +msgid "Import dashboards" +msgstr "Kawemai papatohu" + +msgid "Import database failed for an unknown reason" +msgstr "" +"I rahua te kawemai pātengi raraunga mō tētahi take kāore e mōhiotia ana" + +msgid "Import database from file" +msgstr "Kawemai pātengi raraunga mai i te kōnae" + +msgid "Import dataset failed for an unknown reason" +msgstr "" +"I rahua te kawemai rārangi raraunga mō tētahi take kāore e mōhiotia ana" + +msgid "Import datasets" +msgstr "Kawemai rārangi raraunga" + +msgid "Import queries" +msgstr "Kawemai pātai" + +msgid "Import saved query failed for an unknown reason." +msgstr "" +"I rahua te kawemai pātai kua tiakina mō tētahi take kāore e mōhiotia ana." + +msgid "In" +msgstr "I roto i" + +msgid "" +"In order to connect to non-public sheets you need to either provide a " +"service account or configure an OAuth2 client." +msgstr "" +"Hei hono ki ngā hīti kāore e tūmatanui ana me whakarato koe i tētahi kaute " +"ratonga, me whirihora rānei i tētahi kiritaki OAuth2." + +msgid "Include Series" +msgstr "Whakauru Raupapa" + +msgid "Include a description that will be sent with your report" +msgstr "Whakauru he whakamārama ka tukuna me tō pūrongo" + +#, python-format +msgid "Include description to be sent with %s" +msgstr "Whakauru whakamārama hei tuku me %s" + +msgid "Include series name as an axis" +msgstr "Whakauru ingoa raupapa hei tukutuku" + +msgid "Include time" +msgstr "Whakauru wā" + +msgid "Increase" +msgstr "Piki" + +msgid "Index" +msgstr "Kuputohu" + +msgid "Index column" +msgstr "Tīwae kuputohu" + +msgid "Index label" +msgstr "Tapanga kuputohu" + +#, python-format +msgid "Indexes (%s)" +msgstr "Kuputohu (%s)" + +msgid "Info" +msgstr "Mōhiohio" + +msgid "Inherit range from time filter" +msgstr "Whakawhānau korahi mai i te tātari wā" + +msgid "Inner Radius" +msgstr "Pūtoro O Roto" + +msgid "Inner radius of donut hole" +msgstr "Pūtoro o roto o te poka paraki" + +msgid "Input custom width in pixels" +msgstr "Āpure tāuru whānui ritenga i ngā pika" + +msgid "Input field supports custom rotation. e.g. 30 for 30°" +msgstr "Ka tautoko te āpure tāuru i te hurihuri ritenga. hei tauira 30 mō 30°" + +msgid "Insert Layer URL" +msgstr "Kōkuhu URL Papa" + +msgid "Insert Layer title" +msgstr "Kōkuhu taitara Papa" + +msgid "Intensity" +msgstr "Kaha" + +msgid "Intensity Radius" +msgstr "Pūtoro Kaha" + +msgid "Intensity Radius is the radius at which the weight is distributed" +msgstr "Ko te Pūtoro Kaha te pūtoro ka tohatohaina te taumaha" + +msgid "" +"Intensity is the value multiplied by the weight to obtain the final weight" +msgstr "" +"Ko te Kaha te uara ka whakareaina ki te taumaha hei whiwhi i te taumaha " +"whakamutunga" + +msgid "Interval" +msgstr "Wā" + +msgid "Interval End column" +msgstr "Tīwae Mutunga Wā" + +msgid "Interval bounds" +msgstr "Rohe wā" + +msgid "Interval colors" +msgstr "Tae wā" + +msgid "Interval start column" +msgstr "Tīwae tīmatanga wā" + +msgid "Intervals" +msgstr "Wā" + +msgid "" +"Invalid Connection String: Expecting String of the form " +"'ocient://user:pass@host:port/database'." +msgstr "" +"Aho Hononga Muhu: E tūmanako ana i te Aho o te hōputu " +"'ocient://user:pass@host:port/database'." + +msgid "Invalid JSON" +msgstr "JSON Muhu" + +#, python-format +msgid "Invalid advanced data type: %(advanced_data_type)s" +msgstr "Momo raraunga aromatawai muhu: %(advanced_data_type)s" + +msgid "Invalid certificate" +msgstr "Tiwhikete muhu" + +msgid "" +"Invalid connection string, a valid string usually follows: " +"backend+driver://user:password@database-host/database-name" +msgstr "" +"Aho hononga muhu, he ōrite te aho whaimana ki: " +"backend+driver://user:password@database-host/database-name" + +msgid "" +"Invalid connection string, a valid string usually " +"follows:'DRIVER://USER:PASSWORD@DB-HOST/DATABASE-" +"NAME'

Example:'postgresql://user:password@your-postgres-db/database'

" +msgstr "" +"Aho hononga muhu, he ōrite te aho whaimana ki:'DRIVER://USER:PASSWORD@DB-" +"HOST/DATABASE-NAME'

Tauira:'postgresql://user:password@your-postgres-" +"db/database'

" + +msgid "Invalid cron expression" +msgstr "Kīanga cron muhu" + +#, python-format +msgid "Invalid cumulative operator: %(operator)s" +msgstr "Kaiwhakahaere whakakōputu muhu: %(operator)s" + +msgid "Invalid currency code in saved metrics" +msgstr "Waehere moni muhu i ngā ine kua tiakina" + +msgid "Invalid date/timestamp format" +msgstr "Hōputu rā/waitohu muhu" + +msgid "Invalid executor type" +msgstr "Momo kaiwhakatutuki muhu" + +#, python-format +msgid "Invalid filter operation type: %(op)s" +msgstr "Momo whakahaere tātari muhu: %(op)s" + +msgid "Invalid geodetic string" +msgstr "Aho geodetic muhu" + +msgid "Invalid geohash string" +msgstr "Aho geohash muhu" + +msgid "Invalid input" +msgstr "Tāuru muhu" + +msgid "Invalid lat/long configuration." +msgstr "Whirihora lat/long muhu." + +msgid "Invalid longitude/latitude" +msgstr "Longitude/latitude muhu" + +#, python-format +msgid "Invalid metric object: %(metric)s" +msgstr "Ahanoa ine muhu: %(metric)s" + +#, python-format +msgid "Invalid numpy function: %(operator)s" +msgstr "Taumahi numpy muhu: %(operator)s" + +#, python-format +msgid "Invalid options for %(rolling_type)s: %(options)s" +msgstr "He muhu ngā kōwhiringa mō %(rolling_type)s: %(options)s" + +msgid "Invalid permalink key" +msgstr "Kī hononga-ā-mau muhu" + +#, python-format +msgid "Invalid reference to column: \"%(column)s\"" +msgstr "Tohutoro muhu ki te tīwae: \"%(column)s\"" + +#, python-format +msgid "Invalid result type: %(result_type)s" +msgstr "Momo hua muhu: %(result_type)s" + +#, python-format +msgid "Invalid rolling_type: %(type)s" +msgstr "Rolling_type muhu: %(type)s" + +#, python-format +msgid "Invalid spatial point encountered: %(latlong)s" +msgstr "I tūtaki tohu tauwāhi muhu: %(latlong)s" + +msgid "Invalid state." +msgstr "Tūnga muhu." + +#, python-format +msgid "Invalid tab ids: %s(tab_ids)" +msgstr "Id ripa muhu: %s(tab_ids)" + +msgid "Inverse selection" +msgstr "Tīpakonga whakahuri" + +msgid "Invert current page" +msgstr "Whakahuri whārangi o nāianei" + +msgid "Is active?" +msgstr "Kei te hohe?" + +msgid "Is certified" +msgstr "Kua tautūngia" + +msgid "Is custom tag" +msgstr "He tohu ritenga" + +msgid "Is dimension" +msgstr "He āhuahanga" + +msgid "Is false" +msgstr "He teka" + +msgid "Is favorite" +msgstr "He makau" + +msgid "Is filterable" +msgstr "Ka taea te tātari" + +msgid "Is not null" +msgstr "Ehara i te kore" + +msgid "Is null" +msgstr "He kore" + +msgid "Is tagged" +msgstr "Kua tohuhia" + +msgid "Is temporal" +msgstr "He wā" + +msgid "Is true" +msgstr "He tika" + +msgid "Isoband" +msgstr "Isoband" + +msgid "Isoline" +msgstr "Isoline" + +msgid "Issue 1000 - The dataset is too large to query." +msgstr "Take 1000 - He rahi rawa te rārangi raraunga hei pātai." + +msgid "Issue 1001 - The database is under an unusual load." +msgstr "Take 1001 - Kei raro i tētahi uta rerekē te pātengi raraunga." + +msgid "It’s not recommended to truncate axis in Bar chart." +msgstr "Karekau e tūtohua te porohita i te tukutuku i te kauwhata Pae." + +msgid "JAN" +msgstr "HAU" + +msgid "JSON" +msgstr "JSON" + +msgid "JSON Metadata" +msgstr "Metadata JSON" + +msgid "JSON metadata" +msgstr "Metadata json" + +msgid "JSON metadata is invalid!" +msgstr "He muhu te metadata JSON!" + +msgid "" +"JSON string containing additional connection configuration. This is used to " +"provide connection information for systems like Hive, Presto and BigQuery " +"which do not conform to the username:password syntax normally used by " +"SQLAlchemy." +msgstr "" +"Aho JSON kei roto ngā whirihora hononga taapiri. Ka whakamahia tēnei hei " +"whakarato i te mōhiohio hononga mō ngā pūnaha pērā i te Hive, Presto me " +"BigQuery karekau e whakarite ki te wetereo ingoa-kaiwhakamahi:kupuhipa e " +"whakamahia ana e SQLAlchemy." + +msgid "JUL" +msgstr "HŪR" + +msgid "JUN" +msgstr "HUI" + +msgid "January" +msgstr "Hānuere" + +msgid "JavaScript data interceptor" +msgstr "Kaiwhakawaenga raraunga JavaScript" + +msgid "JavaScript onClick href" +msgstr "JavaScript onClick href" + +msgid "JavaScript tooltip generator" +msgstr "Kaihanga kītukutuku JavaScript" + +msgid "Jinja templating" +msgstr "Tauira Jinja" + +msgid "July" +msgstr "Hūrae" + +msgid "June" +msgstr "Hune" + +msgid "KPI" +msgstr "KPI" + +msgid "Keep control settings?" +msgstr "Pupuri tautuhinga whakahaere?" + +msgid "Keep editing" +msgstr "Haere tonu i te whakatika" + +msgid "Key" +msgstr "Kī" + +msgid "Keyboard shortcuts" +msgstr "Pokatata papatuhi" + +msgid "Keys for table" +msgstr "Kī mō te ripanga" + +msgid "Kilometers" +msgstr "Kiromita" + +msgid "LIMIT" +msgstr "TEPE" + +msgid "Label" +msgstr "Tapanga" + +msgid "Label Contents" +msgstr "Ihirangi Tapanga" + +msgid "Label Line" +msgstr "Rārangi Tapanga" + +msgid "Label Template" +msgstr "Tauira Tapanga" + +msgid "Label Type" +msgstr "Momo Tapanga" + +msgid "Label already exists" +msgstr "Kua tīari kē te tapanga" + +msgid "Label for the index column. Don't use an existing column name." +msgstr "" +"Tapanga mō te tīwae kuputohu. Kaua e whakamahi i tētahi ingoa tīwae kei te " +"tīari." + +msgid "Label for your query" +msgstr "Tapanga mō tō pātai" + +msgid "Label position" +msgstr "Tūnga tapanga" + +msgid "Label threshold" +msgstr "Paepae tapanga" + +msgid "Labelling" +msgstr "Tapanga" + +msgid "Labels" +msgstr "Tapanga" + +msgid "Labels for the marker lines" +msgstr "Tapanga mō ngā rārangi tohu" + +msgid "Labels for the markers" +msgstr "Tapanga mō ngā tohu" + +msgid "Labels for the ranges" +msgstr "Tapanga mō ngā awhe" + +msgid "Large" +msgstr "Nui" + +msgid "Last" +msgstr "Whakamutunga" + +#, python-format +msgid "Last Updated %s" +msgstr "I Whakahouhia Whakamutunga %s" + +#, python-format +msgid "Last Updated %s by %s" +msgstr "I Whakahouhia Whakamutunga %s e %s" + +msgid "Last Value" +msgstr "Uara Whakamutunga" + +#, python-format +msgid "Last available value seen on %s" +msgstr "Uara wātea whakamutunga i kitea i %s" + +msgid "Last day" +msgstr "Rā whakamutunga" + +msgid "Last login" +msgstr "Takiuru whakamutunga" + +msgid "Last modified" +msgstr "I whakarerekeahia whakamutunga" + +msgid "Last month" +msgstr "Marama whakamutunga" + +msgid "Last name" +msgstr "Ingoa whakamutunga" + +msgid "Last name is required" +msgstr "E hiahiatia ana te ingoa whakamutunga" + +msgid "Last quarter" +msgstr "Hautakiwā whakamutunga" + +msgid "Last run" +msgstr "Rere whakamutunga" + +msgid "Last week" +msgstr "Wiki whakamutunga" + +msgid "Last year" +msgstr "Tau whakamutunga" + +msgid "Lat" +msgstr "Lat" + +msgid "Latitude" +msgstr "Latitude" + +msgid "Latitude of default viewport" +msgstr "Latitude o te tirohanga taunoa" + +msgid "Layer" +msgstr "Papa" + +msgid "Layer Name" +msgstr "Ingoa Papa" + +msgid "Layer URL" +msgstr "URL Papa" + +msgid "Layer configuration" +msgstr "Whirihora papa" + +msgid "Layer title" +msgstr "Taitara papa" + +msgid "Layer type" +msgstr "Momo papa" + +msgid "Layers" +msgstr "Papa" + +msgid "Layout" +msgstr "Hoahoa" + +msgid "Layout elements" +msgstr "Huānga hoahoa" + +msgid "Layout type of graph" +msgstr "Momo hoahoa kauwhata" + +msgid "Layout type of tree" +msgstr "Momo hoahoa rākau" + +msgid "Least recently modified" +msgstr "I whakarerekeahia tata nei iti rawa" + +msgid "Left" +msgstr "Mauī" + +msgid "Left Margin" +msgstr "Taiapa Mauī" + +msgid "Left margin, in pixels, allowing for more room for axis labels" +msgstr "" +"Taiapa mauī, i ngā pika, ka tukua he wāhi nui ake mō ngā tapanga tukutuku" + +msgid "Left to Right" +msgstr "Mauī ki Matau" + +msgid "Left value" +msgstr "Uara mauī" + +msgid "Legacy" +msgstr "Tawhito" + +msgid "Legend" +msgstr "Kōrero" + +msgid "Legend Format" +msgstr "Hōputu Kōrero" + +msgid "Legend Orientation" +msgstr "Ahunga Kōrero" + +msgid "Legend Position" +msgstr "Tūnga Kōrero" + +msgid "Legend Type" +msgstr "Momo Kōrero" + +msgid "Legend type" +msgstr "Momo kōrero" + +msgid "Less or equal (<=)" +msgstr "Iti ake, ōrite rānei (<=)" + +msgid "Less than (<)" +msgstr "Iti ake i (<)" + +msgid "Lift percent precision" +msgstr "Tāmau ōrau piki" + +msgid "Light" +msgstr "Māmā" + +msgid "Light mode" +msgstr "Aratau māmā" + +msgid "Like" +msgstr "Rite" + +msgid "Like (case insensitive)" +msgstr "Rite (kore aro reta iti/nui)" + +msgid "Limit type" +msgstr "Momo tepe" + +msgid "Limits the number of cells that get retrieved." +msgstr "Ka whakawhāiti i te maha o ngā pūtau ka tikihia." + +msgid "Limits the number of rows that get displayed." +msgstr "Ka whakawhāiti i te maha o ngā rārangi ka whakaaturia." + +msgid "" +"Limits the number of series that get displayed. A joined subquery (or an " +"extra phase where subqueries are not supported) is applied to limit the " +"number of series that get fetched and rendered. This feature is useful when " +"grouping by high cardinality column(s) though does increase the query " +"complexity and cost." +msgstr "" +"Ka whakawhāiti i te maha o ngā raupapa ka whakaaturia. Ka whakahaeretia " +"tētahi pātai-iti honohono (tētahi wāhanga taapiri rānei mēnā karekau e " +"tautokona ngā pātai-iti) hei whakawhāiti i te maha o ngā raupapa ka tikihia," +" ka whakaaturia hoki. He whaihua tēnei āhuatanga ina rōpū ana mā ngā tīwae " +"cardinality teitei engari ka piki te uauatanga me te utu o te pātai." + +msgid "" +"Limits the number of the rows that are computed in the query that is the " +"source of the data used for this chart." +msgstr "" +"Ka whakawhāiti i te maha o ngā rārangi ka tatauhia i te pātai ko te puna o " +"ngā raraunga mō tēnei kauwhata." + +msgid "Line" +msgstr "Rārangi" + +msgid "Line Chart" +msgstr "Kauwhata Rārangi" + +msgid "Line Style" +msgstr "Kāhua Rārangi" + +msgid "" +"Line chart is used to visualize measurements taken over a given category. " +"Line chart is a type of chart which displays information as a series of data" +" points connected by straight line segments. It is a basic type of chart " +"common in many fields." +msgstr "" +"Ka whakamahia te kauwhata rārangi hei whakakite i ngā ineine kua tangohia i " +"tētahi kāwai. He momo kauwhata te kauwhata rārangi ka whakaatu i te mōhiohio" +" hei raupapa tohu raraunga e honoa ana e ngā wāhanga rārangi tōtika. He momo" +" kauwhata taketake i ngā āpure maha." + +msgid "Line charts on a map" +msgstr "Kauwhata rārangi i runga i tētahi mahere" + +msgid "Line interpolation as defined by d3.js" +msgstr "Takawaenga rārangi e tautuhia ana e d3.js" + +msgid "Line width" +msgstr "Whānui rārangi" + +msgid "Line width unit" +msgstr "Waeine whānui rārangi" + +msgid "Linear Color Scheme" +msgstr "Kaupapa Tae Rārangi" + +msgid "Linear color scheme" +msgstr "Kaupapa tae rārangi" + +msgid "Linear interpolation" +msgstr "Takawaenga rārangi" + +msgid "Lines column" +msgstr "Tīwae rārangi" + +msgid "Lines encoding" +msgstr "Whakakohu rārangi" + +msgid "Link Copied!" +msgstr "Hono Kua Tāruatia!" + +msgid "List Roles" +msgstr "Rārangi Tūranga" + +msgid "List Unique Values" +msgstr "Rārangi Uara Ahurei" + +msgid "List Users" +msgstr "Rārangi Kaiwhakamahi" + +msgid "List of extra columns made available in JavaScript functions" +msgstr "Rārangi tīwae taapiri ka wātea i ngā taumahi JavaScript" + +msgid "List of n+1 values for bucketing metric into n buckets." +msgstr "Rārangi uara n+1 mō te peeke ine ki ngā peeke n." + +msgid "List of the column names that should be read" +msgstr "Rārangi o ngā ingoa tīwae me pānui" + +msgid "List of values to mark with lines" +msgstr "Rārangi uara hei tohu ki ngā rārangi" + +msgid "List of values to mark with triangles" +msgstr "Rārangi uara hei tohu ki ngā tapatoru" + +msgid "List updated" +msgstr "Rārangi kua whakahouhia" + +msgid "Live CSS editor" +msgstr "Etita CSS ora" + +msgid "Live render" +msgstr "Whakaatu ora" + +msgid "Load a CSS template" +msgstr "Uta tētahi tauira CSS" + +msgid "Loaded data cached" +msgstr "Raraunga kua utaina i te keteroki" + +msgid "Loaded from cache" +msgstr "Kua utaina mai i te keteroki" + +msgid "Loading" +msgstr "E uta ana" + +msgid "Loading..." +msgstr "E uta ana..." + +msgid "Locate the chart" +msgstr "Kimihia te kauwhata" + +msgid "Log Scale" +msgstr "Tauine Pūkete" + +msgid "Log retention" +msgstr "Pupuri rārangi" + +msgid "Logarithmic axis" +msgstr "Tukutuku pūkete" + +msgid "Logarithmic scale on primary y-axis" +msgstr "Tauine pūkete i te tukutuku-y matua" + +msgid "Logarithmic scale on secondary y-axis" +msgstr "Tauine pūkete i te tukutuku-y tuarua" + +msgid "Logarithmic x-axis" +msgstr "Tukutuku-x pūkete" + +msgid "Logarithmic y-axis" +msgstr "Tukutuku-y pūkete" + +msgid "Login" +msgstr "Takiuru" + +msgid "Login count" +msgstr "Tatau takiuru" + +msgid "Login with" +msgstr "Takiuru me" + +msgid "Logout" +msgstr "Takiputa" + +msgid "Logs" +msgstr "Rārangi" + +msgid "Lon" +msgstr "Lon" + +msgid "Long dashed" +msgstr "Kani roa" + +msgid "Longitude" +msgstr "Longitude" + +msgid "Longitude & Latitude" +msgstr "Longitude me Latitude" + +msgid "Longitude & Latitude columns" +msgstr "Tīwae Longitude me Latitude" + +msgid "Longitude and Latitude" +msgstr "Longitude me Latitude" + +msgid "Longitude of default viewport" +msgstr "Longitude o te tirohanga taunoa" + +msgid "Lower Threshold" +msgstr "Paepae Raro" + +msgid "Lower threshold must be lower than upper threshold" +msgstr "Me iti ake te paepae raro i te paepae runga" + +msgid "MAR" +msgstr "MAH" + +msgid "MAY" +msgstr "HAR" + +msgid "MINUTE" +msgstr "MENETI" + +msgid "MON" +msgstr "MAN" + +msgid "Main" +msgstr "Matua" + +msgid "" +"Make sure that the controls are configured properly and the datasource " +"contains data for the selected time range" +msgstr "" +"Kia mārama kua whirihorahia tika ngā whakahaere, ā, kei roto i te puna " +"raraunga ngā raraunga mō te awhe wā kua tīpakohia" + +msgid "Make the x-axis categorical" +msgstr "Kia kāwai te tukutuku-x" + +msgid "" +"Malformed request. slice_id or table_name and db_name arguments are expected" +msgstr "Tono hē. E tūmanakohia ana ngā tākupu slice_id, table_name me db_name" + +msgid "Manage" +msgstr "Whakahaere" + +msgid "Manage email report" +msgstr "Whakahaere pūrongo īmēra" + +msgid "Manage your databases" +msgstr "Whakahaere i ō pātengi raraunga" + +msgid "Mandatory" +msgstr "Ā-tikanga" + +msgid "Manually set min/max values for the y-axis." +msgstr "Tautuhi ā-ringa i ngā uara iti/rahi mō te tukutuku-y." + +msgid "Map" +msgstr "Mahere" + +msgid "Map Options" +msgstr "Kōwhiringa Mahere" + +msgid "Map Style" +msgstr "Kāhua Mahere" + +msgid "MapBox" +msgstr "MapBox" + +msgid "Mapbox" +msgstr "Mapbox" + +msgid "March" +msgstr "Poutūterangi" + +msgid "Margin" +msgstr "Taiapa" + +msgid "Mark a column as temporal in \"Edit datasource\" modal" +msgstr "Tohua tētahi tīwae hei wā i te paerewa \"Whakatika puna raraunga\"" + +msgid "Marker" +msgstr "Tohu" + +msgid "Marker Size" +msgstr "Rahi Tohu" + +msgid "Marker labels" +msgstr "Tapanga tohu" + +msgid "Marker line labels" +msgstr "Tapanga rārangi tohu" + +msgid "Marker lines" +msgstr "Rārangi tohu" + +msgid "Marker size" +msgstr "Rahi tohu" + +msgid "Markers" +msgstr "Tohu" + +msgid "Markup type" +msgstr "Momo tohu" + +msgid "Match time shift color with original series" +msgstr "Whakatau tae neke wā ki te raupapa taketake" + +msgid "Max" +msgstr "Rahi" + +msgid "Max Bubble Size" +msgstr "Rahi Pōro Rahi" + +msgid "Max. features" +msgstr "Āhuatanga rahi" + +msgid "Maximum" +msgstr "Rahi" + +msgid "Maximum Font Size" +msgstr "Rahi Momotuhi Rahi" + +msgid "Maximum Radius" +msgstr "Pūtoro Rahi" + +msgid "Maximum number of features to fetch from service" +msgstr "Te maha rahi o ngā āhuatanga hei tiki mai i te ratonga" + +msgid "" +"Maximum radius size of the circle, in pixels. As the zoom level changes, " +"this insures that the circle respects this maximum radius." +msgstr "" +"Rahi pūtoro rahi o te porohita, i ngā pika. I te huringa o te taumata topa, " +"ka whakarite tēnei kia whakaute te porohita i tēnei pūtoro rahi." + +msgid "Maximum value" +msgstr "Uara rahi" + +msgid "Maximum value on the gauge axis" +msgstr "Uara rahi i te tukutuku ine" + +msgid "May" +msgstr "Haratua" + +msgid "Mean of values over specified period" +msgstr "Toharite o ngā uara i te wā kua tohua" + +msgid "Mean values" +msgstr "Uara toharite" + +msgid "Median" +msgstr "Pū" + +msgid "" +"Median edge width, the thickest edge will be 4 times thicker than the " +"thinnest." +msgstr "" +"Whānui tapa pū, ka 4 rawa te mātotoru o te tapa mātotoru rawa i te mea " +"māniniotanga." + +msgid "" +"Median node size, the largest node will be 4 times larger than the smallest" +msgstr "Rahi pona pū, ka 4 rawa te rahi o te pona nui rawa i te mea iti rawa" + +msgid "Median values" +msgstr "Uara pū" + +msgid "Medium" +msgstr "Waenganui" + +msgid "Memory in bytes - binary (1024B => 1KiB)" +msgstr "Mahara i ngā paita - paeruarua (1024B => 1KiB)" + +msgid "Memory in bytes - decimal (1024B => 1.024kB)" +msgstr "Mahara i ngā paita - tekau (1024B => 1.024kB)" + +msgid "Memory transfer rate in bytes - binary (1024B => 1KiB/s)" +msgstr "Tere whakawhiti mahara i ngā paita - paeruarua (1024B => 1KiB/s)" + +msgid "Memory transfer rate in bytes - decimal (1024B => 1.024kB/s)" +msgstr "Tere whakawhiti mahara i ngā paita - tekau (1024B => 1.024kB/s)" + +msgid "Menu actions trigger" +msgstr "Whakaohonga mahinga tahua" + +msgid "Message content" +msgstr "Ihirangi karere" + +msgid "Metadata" +msgstr "Metadata" + +msgid "Metadata Parameters" +msgstr "Tawhā Metadata" + +msgid "Metadata has been synced" +msgstr "Kua hāngaitia te metadata" + +msgid "Method" +msgstr "Tikanga" + +msgid "Metric" +msgstr "Ine" + +#, python-format +msgid "Metric '%(metric)s' does not exist" +msgstr "Karekau te Ine '%(metric)s'" + +msgid "Metric Key" +msgstr "Kī Ine" + +#, python-format +msgid "Metric ``%(metric_name)s`` not found in %(dataset_name)s." +msgstr "Kāore i kitea te Ine ``%(metric_name)s`` i %(dataset_name)s." + +msgid "Metric ascending" +msgstr "Ine piki" + +msgid "Metric assigned to the [X] axis" +msgstr "Ine kua tūtohuhia ki te tukutuku [X]" + +msgid "Metric assigned to the [Y] axis" +msgstr "Ine kua tūtohuhia ki te tukutuku [Y]" + +msgid "Metric change in value from `since` to `until`" +msgstr "Panoni ine i te uara mai i `since` ki `until`" + +msgid "Metric currency" +msgstr "Moni ine" + +msgid "Metric descending" +msgstr "Ine heke" + +msgid "Metric factor change from `since` to `until`" +msgstr "Panoni pūwehe ine mai i `since` ki `until`" + +msgid "Metric for node values" +msgstr "Ine mō ngā uara pona" + +msgid "Metric name" +msgstr "Ingoa ine" + +#, python-format +msgid "Metric name [%s] is duplicated" +msgstr "Kua tāruatia te ingoa ine [%s]" + +msgid "Metric percent change in value from `since` to `until`" +msgstr "Panoni ōrau ine i te uara mai i `since` ki `until`" + +msgid "Metric that defines the size of the bubble" +msgstr "Ine ka tautuhi i te rahi o te pōro" + +msgid "Metric to display bottom title" +msgstr "Ine hei whakaatu i te taitara raro" + +msgid "Metric used as a weight for the grid's coloring" +msgstr "Ine ka whakamahia hei taumaha mō te tae o te tukutata" + +msgid "Metric used to calculate bubble size" +msgstr "Ine ka whakamahia hei tatau i te rahi pōro" + +msgid "Metric used to control height" +msgstr "Ine ka whakamahia hei whakahaere i te teitei" + +msgid "" +"Metric used to define how the top series are sorted if a series or cell " +"limit is present. If undefined reverts to the first metric (where " +"appropriate)." +msgstr "" +"Ine ka whakamahia hei tautuhi i te kōmaka o ngā raupapa runga mēnā he tepe " +"raupapa, tepe pūtau rānei. Mēnā kāore i tautuhia ka hoki ki te ine tuatahi " +"(ina tika)." + +msgid "" +"Metric used to define how the top series are sorted if a series or row limit" +" is present. If undefined reverts to the first metric (where appropriate)." +msgstr "" +"Ine ka whakamahia hei tautuhi i te kōmaka o ngā raupapa runga mēnā he tepe " +"raupapa, tepe rārangi rānei. Mēnā kāore i tautuhia ka hoki ki te ine tuatahi" +" (ina tika)." + +msgid "Metrics" +msgstr "Ine" + +msgid "Middle" +msgstr "Waenganui" + +msgid "Midnight" +msgstr "Weherua pō" + +msgid "Miles" +msgstr "Maero" + +msgid "Min" +msgstr "Iti" + +msgid "Min Periods" +msgstr "Wā Iti" + +msgid "Min Width" +msgstr "Whānui Iti" + +msgid "Min periods" +msgstr "Wā iti" + +msgid "Min/max (no outliers)" +msgstr "Iti/rahi (karekau he wāhitauwehe)" + +msgid "Mine" +msgstr "Nōku" + +msgid "Minimum" +msgstr "Iti" + +msgid "Minimum Font Size" +msgstr "Rahi Momotuhi Iti" + +msgid "Minimum Radius" +msgstr "Pūtoro Iti" + +msgid "Minimum must be strictly less than maximum" +msgstr "Me iti noa atu te iti i te rahi" + +msgid "" +"Minimum radius size of the circle, in pixels. As the zoom level changes, " +"this insures that the circle respects this minimum radius." +msgstr "" +"Rahi pūtoro iti o te porohita, i ngā pika. I te huringa o te taumata topa, " +"ka whakarite tēnei kia whakaute te porohita i tēnei pūtoro iti." + +msgid "Minimum threshold in percentage points for showing labels." +msgstr "Paepae iti i ngā tohu ōrau mō te whakaatu i ngā tapanga." + +msgid "Minimum value" +msgstr "Uara iti" + +msgid "Minimum value cannot be higher than maximum value" +msgstr "Kāore e taea e te uara iti te teitei ake i te uara rahi" + +msgid "Minimum value for label to be displayed on graph." +msgstr "Uara iti mō te tapanga kia whakaaturia i te kauwhata." + +msgid "Minimum value on the gauge axis" +msgstr "Uara iti i te tukutuku ine" + +msgid "Minor Split Line" +msgstr "Rārangi Wehe Iti" + +msgid "Minor ticks" +msgstr "Tika iti" + +msgid "Minute" +msgstr "Meneti" + +#, python-format +msgid "Minutes %s" +msgstr "Meneti %s" + +msgid "Minutes value" +msgstr "Uara meneti" + +msgid "Missing OAuth2 token" +msgstr "Kei te ngaro te tohu OAuth2" + +msgid "Missing URL parameters" +msgstr "Kei te ngaro ngā tawhā URL" + +msgid "Missing dataset" +msgstr "Rārangi raraunga ngaro" + +msgid "Mixed Chart" +msgstr "Kauwhata Whakananu" + +msgid "Modified" +msgstr "Kua Whakarerekeahia" + +#, python-format +msgid "Modified %s" +msgstr "Kua Whakarerekeahia %s" + +#, python-format +msgid "Modified 1 column in the virtual dataset" +msgid_plural "Modified %s columns in the virtual dataset" +msgstr[0] "I whakarerekeahia 1 tīwae i te rārangi raraunga mariko" +msgstr[1] "I whakarerekeahia %s tīwae i te rārangi raraunga mariko" + +msgid "Modified by" +msgstr "I whakarerekeahia e" + +#, python-format +msgid "Modified by: %s" +msgstr "I whakarerekeahia e: %s" + +msgid "Monday" +msgstr "Mane" + +msgid "Month" +msgstr "Marama" + +#, python-format +msgid "Months %s" +msgstr "Marama %s" + +msgid "More" +msgstr "Atu" + +msgid "More filters" +msgstr "Tātari atu" + +msgid "MotherDuck token" +msgstr "Tohu MotherDuck" + +msgid "Move only" +msgstr "Neke anake" + +msgid "Moves the given set of dates by a specified interval." +msgstr "Ka neke i te huinga rā kua tukuna mā tētahi wā kua tohua." + +msgid "Multi-Dimensions" +msgstr "Āhuahanga-Maha" + +msgid "Multi-Layers" +msgstr "Papa-Maha" + +msgid "Multi-Levels" +msgstr "Taumata-Maha" + +msgid "Multi-Variables" +msgstr "Taurangi-Maha" + +msgid "Multiple" +msgstr "Maha" + +msgid "Multiple filtering" +msgstr "Tātari maha" + +msgid "" +"Multiple formats accepted, look the geopy.points Python library for more " +"details" +msgstr "" +"Ka whakaae i ngā hōputu maha, tirohia te whare pukapuka Python geopy.points " +"mō ētahi taipitopito atu" + +msgid "Multiplier" +msgstr "Kaiwhakarea" + +msgid "Must be unique" +msgstr "Me ahurei" + +msgid "Must choose either a chart or a dashboard" +msgstr "Me kōwhiri tētahi kauwhata, tētahi papatohu rānei" + +msgid "Must have a [Group By] column to have 'count' as the [Label]" +msgstr "Me whai tīwae [Rōpū Mā] kia 'tatau' te [Tapanga]" + +msgid "Must provide credentials for the SSH Tunnel" +msgstr "Me whakarato i ngā taipitopito mō te SSH Tunnel" + +msgid "Must specify a value for filters with comparison operators" +msgstr "Me tohu he uara mō ngā tātari me ngā kaiwhakahaere whakatairite" + +msgid "My beautiful colors" +msgstr "Ōku tae ātaahua" + +msgid "My column" +msgstr "Taku tīwae" + +msgid "My metric" +msgstr "Taku ine" + +msgid "N/A" +msgstr "N/A" + +msgid "NOT GROUPED BY" +msgstr "KĀORE I RŌPŪNGIA MĀ" + +msgid "NOV" +msgstr "WHI" + +msgid "NUMERIC" +msgstr "TAU" + +msgid "Name" +msgstr "Ingoa" + +msgid "Name is required" +msgstr "E hiahiatia ana he ingoa" + +msgid "Name must be unique" +msgstr "Me ahurei te ingoa" + +msgid "Name of table to be created" +msgstr "Ingoa o te ripanga ka hangaia" + +msgid "Name of the column containing the id of the parent node" +msgstr "Ingoa o te tīwae kei roto te id o te pona mātua" + +msgid "Name of the id column" +msgstr "Ingoa o te tīwae id" + +msgid "Name of the source nodes" +msgstr "Ingoa o ngā pona puna" + +msgid "Name of the target nodes" +msgstr "Ingoa o ngā pona whāinga" + +msgid "Name of your tag" +msgstr "Ingoa o tō tohu" + +msgid "Name your database" +msgstr "Tohua he ingoa mō tō pātengi raraunga" + +msgid "Need help? Learn how to connect your database" +msgstr "E hiahia āwhina ana? Akona me pēhea te hono i tō pātengi raraunga" + +msgid "Need help? Learn more about" +msgstr "E hiahia āwhina ana? Ako atu mō" + +msgid "Network Error" +msgstr "Hapa Whatunga" + +msgid "Network error" +msgstr "Hapa whatunga" + +msgid "Network error while attempting to fetch resource" +msgstr "Hapa whatunga i te wā e ngana ana ki te tiki rauemi" + +msgid "Network error." +msgstr "Hapa whatunga." + +msgid "New chart" +msgstr "Kauwhata hou" + +msgid "New dataset" +msgstr "Rārangi raraunga hou" + +msgid "New dataset name" +msgstr "Ingoa rārangi raraunga hou" + +msgid "New header" +msgstr "Pane hou" + +msgid "New tab" +msgstr "Ripa hou" + +msgid "New tab (Ctrl + q)" +msgstr "Ripa hou (Ctrl + q)" + +msgid "New tab (Ctrl + t)" +msgstr "Ripa hou (Ctrl + t)" + +msgid "Next" +msgstr "Panuku" + +msgid "Nightingale" +msgstr "Nightingale" + +msgid "Nightingale Rose Chart" +msgstr "Kauwhata Rōhi Nightingale" + +msgid "No" +msgstr "Kāo" + +#, python-format +msgid "No %s yet" +msgstr "Kāore anō he %s" + +msgid "No Data" +msgstr "Kāore He Raraunga" + +msgid "No Results" +msgstr "Kāore He Hua" + +msgid "No Rules yet" +msgstr "Kāore anō he Ture" + +msgid "No Tags created" +msgstr "Kāore anō kia hangaia he Tohu" + +msgid "No actions" +msgstr "Kāore he mahinga" + +msgid "No annotation layers" +msgstr "Kāore he papa tohu" + +msgid "No annotation layers yet" +msgstr "Kāore anō he papa tohu" + +msgid "No annotation yet" +msgstr "Kāore anō he tohu" + +msgid "No applied filters" +msgstr "Kāore he tātari kua whakahaeretia" + +msgid "No available filters." +msgstr "Kāore he tātari wātea." + +msgid "No charts" +msgstr "Kāore he kauwhata" + +msgid "No columns found" +msgstr "Kāore i kitea he tīwae" + +msgid "No compatible catalog found" +msgstr "Kāore i kitea he kātaloka hāngai" + +msgid "No compatible columns found" +msgstr "Kāore i kitea he tīwae hāngai" + +msgid "No compatible datasets found" +msgstr "Kāore i kitea he rārangi raraunga hāngai" + +msgid "No compatible schema found" +msgstr "Kāore i kitea he hanga hāngai" + +msgid "No data" +msgstr "Kāore he raraunga" + +msgid "No data after filtering or data is NULL for the latest time record" +msgstr "" +"Kāore he raraunga i muri i te tātari, he NULL rānei ngā raraunga mō te " +"rekoata wā whakamutunga" + +msgid "No data in file" +msgstr "Kāore he raraunga i te kōnae" + +msgid "No databases available" +msgstr "Kāore he pātengi raraunga wātea" + +msgid "No databases match your search" +msgstr "Kāore he pātengi raraunga e hāngai ana ki tō rapu" + +msgid "No description available." +msgstr "Kāore he whakamārama wātea." + +msgid "No entities have this tag currently assigned" +msgstr "Kāore he pūtahi kei te whai i tēnei tohu i tēnei wā" + +msgid "No filter" +msgstr "Kāore he tātari" + +msgid "No filter is selected." +msgstr "Kāore i tīpakohia he tātari." + +msgid "No filters" +msgstr "Kāore he tātari" + +msgid "No filters are currently added to this dashboard." +msgstr "Kāore he tātari kua tāpiritia ki tēnei papatohu i tēnei wā." + +msgid "No form settings were maintained" +msgstr "Kāore i puritia he tautuhinga puka" + +msgid "No global filters are currently added" +msgstr "Kāore he tātari ao whānui kua tāpiritia i tēnei wā" + +msgid "No matching records found" +msgstr "Kāore i kitea he rekoata hāngai" + +msgid "No records found" +msgstr "Kāore i kitea he rekoata" + +msgid "No results" +msgstr "Kāore he hua" + +msgid "No results found" +msgstr "Kāore i kitea he hua" + +msgid "No results match your filter criteria" +msgstr "Kāore he hua e hāngai ana ki ō paearu tātari" + +msgid "No results were returned for this query" +msgstr "Kāore i whakahokia mai he hua mō tēnei pātai" + +msgid "" +"No results were returned for this query. If you expected results to be " +"returned, ensure any filters are configured properly and the datasource " +"contains data for the selected time range." +msgstr "" +"Kāore i whakahokia mai he hua mō tēnei pātai. Mēnā i tūmanakohia kia " +"whakahokia mai ngā hua, kia mārama kua whirihorahia tika ngā tātari katoa, " +"ā, kei roto i te puna raraunga ngā raraunga mō te awhe wā kua tīpakohia." + +msgid "No roles yet" +msgstr "Kāore anō he tūranga" + +msgid "No rows were returned for this dataset" +msgstr "Kāore i whakahokia mai he rārangi mō tēnei rārangi raraunga" + +msgid "No samples were returned for this dataset" +msgstr "Kāore i whakahokia mai he tauira mō tēnei rārangi raraunga" + +msgid "No saved expressions found" +msgstr "Kāore i kitea he kīanga kua tiakina" + +msgid "No saved metrics found" +msgstr "Kāore i kitea he ine kua tiakina" + +msgid "No stored results found, you need to re-run your query" +msgstr "Kāore i kitea he hua kua penapena, me whakahaere anō koe i tō pātai" + +msgid "No such column found. To filter on a metric, try the Custom SQL tab." +msgstr "" +"Kāore i kitea tēnei tīwae. Hei tātari i tētahi ine, whakamātauhia te ripa " +"SQL Ritenga." + +msgid "No table columns" +msgstr "Kāore he tīwae ripanga" + +msgid "No temporal columns found" +msgstr "Kāore i kitea he tīwae wā" + +msgid "No time columns" +msgstr "Kāore he tīwae wā" + +msgid "No users yet" +msgstr "Kāore anō he kaiwhakamahi" + +msgid "No validator found (configured for the engine)" +msgstr "Kāore i kitea he kaimanatoko (kua whirihorahia mō te pūkaha)" + +#, python-format +msgid "" +"No validator named %(validator_name)s found (configured for the " +"%(engine_spec)s engine)" +msgstr "" +"Kāore i kitea he kaimanatoko ko %(validator_name)s te ingoa (kua " +"whirihorahia mō te pūkaha %(engine_spec)s)" + +msgid "Node label position" +msgstr "Tūnga tapanga pona" + +msgid "Node select mode" +msgstr "Aratau tīpako pona" + +msgid "Node size" +msgstr "Rahi pona" + +msgid "None" +msgstr "Kāore" + +msgid "None -> Arrow" +msgstr "Kāore -> Pere" + +msgid "None -> None" +msgstr "Kāore -> Kāore" + +msgid "Normal" +msgstr "Noa" + +msgid "Normalize" +msgstr "Whakawhānui" + +msgid "Normalize Across" +msgstr "Whakawhānui Puta Noa" + +msgid "Normalize column names" +msgstr "Whakawhānuitia ingoa tīwae" + +msgid "Normalized" +msgstr "Kua Whakawhānuitia" + +msgid "Not Time Series" +msgstr "Ehara i te Raupapa Wā" + +msgid "Not a valid ZIP file" +msgstr "Ehara i te kōnae ZIP whaimana" + +msgid "Not added to any dashboard" +msgstr "Kāore i tāpiritia ki tētahi papatohu" + +msgid "Not all required fields are complete. Please provide the following:" +msgstr "Kāore i oti ngā āpure katoa e hiahiatia ana. Tēnā whakarato i ēnei:" + +msgid "Not available" +msgstr "Karekau e wātea ana" + +msgid "Not defined" +msgstr "Kāore i tautuhia" + +msgid "Not equal to (≠)" +msgstr "Kāore e ōrite ki (≠)" + +msgid "Not in" +msgstr "Kāore i roto i" + +msgid "Not null" +msgstr "Ehara i te kore" + +msgid "Not triggered" +msgstr "Kāore i whakaohongia" + +msgid "Not up to date" +msgstr "Kāore i te hou" + +msgid "Nothing here yet" +msgstr "Karekau he mea ki konei" + +msgid "Nothing triggered" +msgstr "Karekau i whakaohongia" + +msgid "Notification Method" +msgstr "Tikanga Whakamōhio" + +msgid "Notification method" +msgstr "Tikanga whakamōhio" + +msgid "November" +msgstr "Noema" + +msgid "Now" +msgstr "Ināianei" + +msgid "Null Values" +msgstr "Uara Kore" + +msgid "Null imputation" +msgstr "Whakakapi kore" + +msgid "Null or Empty" +msgstr "Kore, Kau rānei" + +msgid "Number Format" +msgstr "Hōputu Tau" + +msgid "" +"Number bounds used for color encoding from red to blue.\n" +" Reverse the numbers for blue to red. To get pure red or blue,\n" +" you can enter either only min or max." +msgstr "" +"Rohe tau ka whakamahia mō te whakakohu tae mai i te whero ki te kikorangi." + +msgid "Number format" +msgstr "Hōputu tau" + +msgid "Number format string" +msgstr "Aho hōputu tau" + +msgid "Number formatting" +msgstr "Hōputu tau" + +msgid "Number of buckets to group data" +msgstr "Maha o ngā pouaka hei rōpū raraunga" + +msgid "Number of decimal digits to round numbers to" +msgstr "Maha o ngā mati hautanga hei porowhita i ngā tau" + +msgid "Number of decimal places with which to display lift values" +msgstr "Maha o ngā wāhi hautanga hei whakaatu i ngā uara hapai" + +msgid "Number of decimal places with which to display p-values" +msgstr "Maha o ngā wāhi hautanga hei whakaatu i ngā uara-p" + +msgid "" +"Number of periods to compare against. You can use negative numbers to " +"compare from the beginning of the time range." +msgstr "" +"Maha o ngā wā hei whakatairite. Ka taea e koe te whakamahi i ngā tau kino " +"hei whakatairite mai i te tīmatanga o te awhe wā." + +msgid "Number of periods to ratio against" +msgstr "Maha o ngā wā hei ōwehenga ki" + +msgid "Number of rows of file to read. Leave empty (default) to read all rows" +msgstr "" +"Maha o ngā rārangi kōnae hei pānui. Waiho kau (taunoa) hei pānui i ngā " +"rārangi katoa" + +msgid "Number of rows to skip at start of file." +msgstr "Maha o ngā rārangi hei poke i te tīmatanga o te kōnae." + +msgid "Number of split segments on the axis" +msgstr "Maha o ngā wāhanga wehe i te tukutuku" + +msgid "Number of steps to take between ticks when displaying the X scale" +msgstr "" +"Maha o ngā takahanga hei mau i waenga i ngā tika ina whakaatu i te tauine X" + +msgid "Number of steps to take between ticks when displaying the Y scale" +msgstr "" +"Maha o ngā takahanga hei mau i waenga i ngā tika ina whakaatu i te tauine Y" + +msgid "Numeric column used to calculate the histogram." +msgstr "Tīwae tau ka whakamahia hei tatau i te kauwhata auau." + +msgid "Numerical range" +msgstr "Awhe tau" + +msgid "OCT" +msgstr "OKO" + +msgid "OK" +msgstr "PAI" + +msgid "OVERWRITE" +msgstr "TUHIRUA" + +msgid "October" +msgstr "Oketopa" + +msgid "Offline" +msgstr "Tuimotu" + +msgid "On Grace" +msgstr "I runga i te Aroha" + +msgid "On dashboards" +msgstr "I ngā papatohu" + +msgid "" +"One or many columns to group by. High cardinality groupings should include a" +" series limit to limit the number of fetched and rendered series." +msgstr "" +"Tīwae kotahi, nui ake rānei hei rōpū mā. Ko ngā rōpū mā teitei te " +"cardinality me whai i tētahi tepe raupapa hei whakawhāiti i te maha o ngā " +"raupapa kua tikina, kua whakaaturia." + +msgid "" +"One or many controls to group by. If grouping, latitude and longitude " +"columns must be present." +msgstr "" +"Whakahaere kotahi, nui ake rānei hei rōpū mā. Mēnā e rōpū ana, me tīari ngā " +"tīwae latitude me longitude." + +msgid "One or many controls to pivot as columns" +msgstr "Kōwhiringa kotahi, nui ake rānei hei hurihuri hei tīwae" + +msgid "One or many metrics to display" +msgstr "Ine kotahi, nui ake rānei hei whakaatu" + +msgid "One or more annotation layers failed loading." +msgstr "I rahua te utanga o tētahi, nui ake rānei papa tohu." + +msgid "One or more columns already exist" +msgstr "Kua tīari kētia tētahi, nui ake rānei tīwae" + +msgid "One or more columns are duplicated" +msgstr "Kua tāruatia tētahi, nui ake rānei tīwae" + +msgid "One or more columns do not exist" +msgstr "Karekau tētahi, nui ake rānei tīwae" + +msgid "One or more metrics already exist" +msgstr "Kua tīari kētia tētahi, nui ake rānei ine" + +msgid "One or more metrics are duplicated" +msgstr "Kua tāruatia tētahi, nui ake rānei ine" + +msgid "One or more metrics do not exist" +msgstr "Karekau tētahi, nui ake rānei ine" + +msgid "One or more parameters needed to configure a database are missing." +msgstr "" +"Kei te ngaro tētahi, nui ake rānei tawhā e hiahiatia ana hei whirihora i " +"tētahi pātengi raraunga." + +msgid "One or more parameters specified in the query are malformed." +msgstr "Kua hē tētahi, nui ake rānei tawhā kua tohua i te pātai." + +msgid "One or more parameters specified in the query are missing." +msgstr "Kei te ngaro tētahi, nui ake rānei tawhā kua tohua i te pātai." + +msgid "Only Total" +msgstr "Te Tapeke Anake" + +msgid "Only `SELECT` statements are allowed" +msgstr "Ko ngā kīanga `SELECT` anake e whakāetia ana" + +msgid "Only applies when \"Label Type\" is not set to a percentage." +msgstr "Ka pā anake ina kāore te \"Momo Tapanga\" i tautuhia hei ōrau." + +msgid "Only applies when \"Label Type\" is set to show values." +msgstr "Ka pā anake ina tautuhia te \"Momo Tapanga\" ki te whakaatu i ngā uara." + +msgid "" +"Only show the total value on the stacked chart, and not show on the selected" +" category" +msgstr "" +"Whakaatu anake te uara tapeke i te kauwhata paparanga, ā, kaua e whakaatu i " +"te kāwai kua tīpakohia" + +msgid "Only single queries supported" +msgstr "Ko ngā pātai kotahi anake e tautokona ana" + +msgid "Oops! An error occurred!" +msgstr "Aue! I puta he hapa!" + +msgid "Opacity" +msgstr "Ataata" + +msgid "Opacity of Area Chart. Also applies to confidence band." +msgstr "Ataata o te Kauwhata Horahanga. Ka pā hoki ki te pae pono." + +msgid "Opacity of all clusters, points, and labels. Between 0 and 1." +msgstr "" +"Ataata o ngā rāpaki katoa, ngā tohu, me ngā tapanga. I waenga i te 0 me te " +"1." + +msgid "Opacity of area chart." +msgstr "Ataata o te kauwhata horahanga." + +msgid "Opacity of bubbles, 0 means completely transparent, 1 means opaque" +msgstr "Ataata o ngā pōro, 0 he ataata katoa, 1 he kino" + +msgid "Opacity, expects values between 0 and 100" +msgstr "Ataata, e tūmanako ana i ngā uara i waenga i te 0 me te 100" + +msgid "Open Datasource tab" +msgstr "Huaki ripa Puna Raraunga" + +msgid "Open in SQL Lab" +msgstr "Huaki i SQL Lab" + +msgid "Open query in SQL Lab" +msgstr "Huaki pātai i SQL Lab" + +msgid "" +"Operate the database in asynchronous mode, meaning that the queries are " +"executed on remote workers as opposed to on the web server itself. This " +"assumes that you have a Celery worker setup as well as a results backend. " +"Refer to the installation docs for more information." +msgstr "" +"Whakahaere i te pātengi raraunga i te aratau kore-hangarite, arā ka " +"whakatutukia ngā pātai i ngā kaimahi tawhiti kaua i runga i te tūmau " +"tukutuku tonu. E whakapae ana tēnei he whirihoranga kaimahi Celery tōu me " +"tētahi tuarongo hua. Tirohia ngā tuhinga tāuta mō ētahi mōhiohio atu." + +msgid "Operator" +msgstr "Kaiwhakahaere" + +#, python-format +msgid "Operator undefined for aggregator: %(name)s" +msgstr "Kāore i tautuhia te kaiwhakahaere mō te kaiwhakaārotau: %(name)s" + +msgid "" +"Optional CA_BUNDLE contents to validate HTTPS requests. Only available on " +"certain database engines." +msgstr "" +"Ihirangi CA_BUNDLE kōwhiringa hei manatoko i ngā tono HTTPS. Kei te wātea " +"anake i ētahi pūkaha pātengi raraunga." + +msgid "Optional d3 date format string" +msgstr "Aho hōputu rā d3 kōwhiringa" + +msgid "Optional d3 number format string" +msgstr "Aho hōputu tau d3 kōwhiringa" + +msgid "Optional name of the data column." +msgstr "Ingoa kōwhiringa o te tīwae raraunga." + +msgid "Optional warning about use of this metric" +msgstr "Whakatūpato kōwhiringa mō te whakamahinga o tēnei ine" + +msgid "Options" +msgstr "Kōwhiringa" + +msgid "Or choose from a list of other databases we support:" +msgstr "" +"Kōwhiria rānei mai i tētahi rārangi o ētahi atu pātengi raraunga e tautokona" +" e mātou:" + +msgid "Order results by selected columns" +msgstr "Raupapa hua mā ngā tīwae kua tīpakohia" + +msgid "Ordering" +msgstr "Raupapa" + +msgid "" +"Orders the query result that generates the source data for this chart. If a " +"series or row limit is reached, this determines what data are truncated. If " +"undefined, defaults to the first metric (where appropriate)." +msgstr "" +"Ka raupapa i te hua pātai ka hanga i te puna raraunga mō tēnei kauwhata. " +"Mēnā ka tae ki tētahi tepe raupapa, tepe rārangi rānei, ka whakatau tēnei ko" +" ēhea ngā raraunga ka porohitatia. Mēnā kāore i tautuhia, ka heke ki te ine " +"tuatahi (ina tika)." + +msgid "Orientation" +msgstr "Ahunga" + +msgid "Orientation of bar chart" +msgstr "Ahunga o te kauwhata pae" + +msgid "Orientation of filter bar" +msgstr "Ahunga o te pae tātari" + +msgid "Orientation of tree" +msgstr "Ahunga o te rākau" + +msgid "Original" +msgstr "Taketake" + +msgid "Original table column order" +msgstr "Raupapa tīwae ripanga taketake" + +msgid "Original value" +msgstr "Uara taketake" + +msgid "Orthogonal" +msgstr "Hāngai" + +msgid "Other" +msgstr "Ētahi Atu" + +msgid "Other color palettes" +msgstr "Paka tae atu" + +msgid "Outdoors" +msgstr "Arawaho" + +msgid "Outer Radius" +msgstr "Pūtoro Waho" + +msgid "Outer edge of Pie chart" +msgstr "Tapa waho o te kauwhata Pai" + +msgid "Overlap" +msgstr "Whārua" + +msgid "" +"Overlay one or more timeseries from a relative time period. Expects relative" +" time deltas in natural language (example: 24 hours, 7 days, 52 weeks, 365 " +"days). Free text is supported." +msgstr "" +"Ka kōpaki i tētahi tukutata ono-tapa i runga i tētahi mahere, ā, ka " +"whakaarotau i ngā raraunga i roto i te rohe o ia pūtau." + +msgid "" +"Overlay one or more timeseries from a relative time period. Expects relative" +" time deltas in natural language (example: 24 hours, 7 days, 52 weeks, 365 " +"days). Free text is supported." +msgstr "Whakakapi māeneene wā" + +msgid "" +"Overlay results from a relative time period. Expects relative time deltas in" +" natural language (example: 24 hours, 7 days, 52 weeks, 365 days). Free " +"text is supported. Use \"Inherit range from time filters\" to shift the " +"comparison time range by the same length as your time range and use " +"\"Custom\" to set a custom comparison range." +msgstr "Whakakapi awhe wā" + +msgid "" +"Overlays a hexagonal grid on a map, and aggregates data within the boundary " +"of each cell." +msgstr "Tuhirua" + +msgid "Override time grain" +msgstr "Tuhirua & Tūhura" + +msgid "Override time range" +msgstr "Tuhirua Papatohu [%s]" + +msgid "Overwrite" +msgstr "Tuhirua kei te tīari" + +msgid "Overwrite & Explore" +msgstr "Tuhirua kupu i te etita ki tētahi pātai i runga i tēnei ripanga" + +#, python-format +msgid "Overwrite Dashboard [%s]" +msgstr "Nōna Kua Hangaia, Kua Makauhia rānei" + +msgid "Overwrite existing" +msgstr "Rangatira" + +msgid "Overwrite text in the editor with a query on this table" +msgstr "Rangatira" + +msgid "Owned Created or Favored" +msgstr "He muhu ngā rangatira" + +msgid "Owner" +msgstr "" +"He rārangi kaiwhakamahi ngā Rangatira ka taea te whakarereke i te papatohu." + +msgid "Owners" +msgstr "" +"He rārangi kaiwhakamahi ngā Rangatira ka taea te whakarereke i te papatohu. " +"Ka taea te rapu mā te ingoa, mā te ingoa kaiwhakamahi rānei." + +msgid "Owners are invalid" +msgstr "I rahua te tikiake PDF, tēnā whakahouhia, ā, whakamātauhia anō." + +msgid "Owners is a list of users who can alter the dashboard." +msgstr "Roa whārangi" + +msgid "" +"Owners is a list of users who can alter the dashboard. Searchable by name or" +" username." +msgstr "Ripanga Whakamātau-t Takirua" + +msgid "PDF download failed, please refresh and try again." +msgstr "Tikanga tauira-anō Pandas" + +msgid "Page length" +msgstr "Ture tauira-anō Pandas" + +msgid "Paired t-test Table" +msgstr "Tūtohi Tukutahi" + +msgid "Pandas resample method" +msgstr "Hapa tawhā" + +msgid "Pandas resample rule" +msgstr "Tawhā" + +msgid "Parallel Coordinates" +msgstr "Tawhā " + +msgid "Parameter error" +msgstr "Tawhā e pā ana ki te tirohanga me te tirohanga i runga i te mahere" + +msgid "Parameters" +msgstr "Mātua" + +msgid "Parameters " +msgstr "Hapa poroporo: %(error)s" + +msgid "Parameters related to the view and perspective on the map" +msgstr "Wāhanga o te Katoa" + +msgid "Parent" +msgstr "Kauwhata Wāhanga" + +#, python-format +msgid "Parsing error: %(error)s" +msgstr "Hoahoa Wāhanga" + +msgid "Part of a Whole" +msgstr "Tepe Wāhanga" + +msgid "Partition Chart" +msgstr "Paepae Wāhanga" + +msgid "Partition Diagram" +msgstr "" +"Ka purua ngā wāhanga kei raro i tēnei uara te ōwehenga o te teitei ki te " +"teitei mātua" + +msgid "Partition Limit" +msgstr "Kupuhipa" + +msgid "Partition Threshold" +msgstr "E hiahiatia ana he kupuhipa" + +msgid "" +"Partitions whose height to parent height proportions are below this value " +"are pruned" +msgstr "Karekau e hāngai ngā kupuhipa!" + +msgid "Password" +msgstr "Whakapiri Kī Matawhā ki konei" + +msgid "Password is required" +msgstr "Whakapiri ihirangi o te kōnae JSON taipitopito ratonga ki konei" + +msgid "Passwords do not match!" +msgstr "Whakapiri te URL Google Sheet tāria ki konei" + +msgid "Paste Private Key here" +msgstr "Whakapiri tō tohu urunga ki konei" + +msgid "Paste content of service credentials JSON file here" +msgstr "Tauira" + +msgid "Paste the shareable Google Sheet URL here" +msgstr "Panoni Ōrau" + +msgid "Paste your access token here" +msgstr "Hōputu Rerekētanga Ōrau" + +msgid "Pattern" +msgstr "Ōrau o te katoa" + +msgid "Percent Change" +msgstr "Ōrau" + +msgid "Percent Difference format" +msgstr "Panoni ōrau" + +msgid "Percent of total" +msgstr "Rerekētanga ōrau i waenga i ngā wā" + +msgid "Percentage" +msgstr "Ine ōrau" + +msgid "Percentage change" +msgstr "Paepae ōrau" + +msgid "Percentage difference between the time periods" +msgstr "Ōrau" + +msgid "Percentage metrics" +msgstr "Whakatutukitanga" + +msgid "Percentage threshold" +msgstr "Toharite wā" + +msgid "Percentages" +msgstr "Wā" + +msgid "Performance" +msgstr "Me noho ngā wā hei tau katoa" + +msgid "Period average" +msgstr "Mōtika" + +msgid "Periods" +msgstr "Kua hāngaitia ngā mōtika mō %s" + +msgid "Periods must be a whole number" +msgstr "Tangata, rōpū rānei nāna i tautuhi tēnei kauwhata." + +msgid "Permissions" +msgstr "Tangata, rōpū rānei nāna i tautuhi tēnei papatohu." + +#, python-format +msgid "Permissions successfully synced for %s" +msgstr "Tangata, rōpū rānei nāna i tautuhi tēnei ine" + +msgid "Person or group that has certified this chart." +msgstr "Kikokiko" + +msgid "Person or group that has certified this dashboard." +msgstr "Kikokiko (ripanga, tirohanga rānei)" + +msgid "Person or group that has certified this metric" +msgstr "Tīpakohia tētahi āhuahanga ka tautuhia ai ngā tae kāwai" + +msgid "Physical" +msgstr "Tīpakohia tētahi ine mō te x, y me te rahi" + +msgid "Physical (table or view)" +msgstr "Tīpakohia tētahi ine hei whakaatu" + +msgid "Pick a dimension from which categorical colors are defined" +msgstr "" +"Tīpakohia he ingoa hei āwhina i a koe ki te tautuhi i tēnei pātengi " +"raraunga." + +msgid "Pick a metric for x, y and size" +msgstr "" +"Tīpakohia he ingoa whakaingoa mō te whakaaturanga o te pātengi raraunga i " +"Superset." + +msgid "Pick a metric to display" +msgstr "" +"Tīpakohia tētahi huinga kauwhata deck.gl hei papa i runga i tētahi i tētahi" + +msgid "Pick a name to help you identify this database." +msgstr "Tīpakohia he taitara mō tō tohu." + +msgid "Pick a nickname for how the database will display in Superset." +msgstr "Tīpakohia kotahi ine, nui ake rānei" + +msgid "Pick a set of deck.gl charts to layer on top of one another" +msgstr "" +"Tīpakohia tētahi, nui ake rānei tīwae me whakaatu i te tohu. Mēnā karekau " +"koe e tīpako i tētahi tīwae ka whakaaturia ngā mea katoa." + +msgid "Pick a title for you annotation." +msgstr "Tīpakohia tō reo tohu makau" + +msgid "Pick at least one metric" +msgstr "Kauwhata Pai" + +msgid "" +"Pick one or more columns that should be shown in the annotation. If you " +"don't select a column all of them will be shown." +msgstr "Kauwhata pai i runga i tētahi mahere" + +msgid "Pick your favorite markup language" +msgstr "Hanga pai" + +msgid "Pie Chart" +msgstr "Wāhiwāhi" + +msgid "Pie charts on a map" +msgstr "Pine" + +msgid "Pie shape" +msgstr "Pine Mauī" + +msgid "Piecewise" +msgstr "Pine Matau" + +msgid "Pin" +msgstr "Ripanga Hurihuri" + +msgid "Pin Left" +msgstr "Me whai te mahinga hurihuri i te kotahi whakaarotau nui rawa" + +msgid "Pin Right" +msgstr "E hiahiatia ana e te mahinga hurihuri te kotahi kuputohu nui rawa" + +msgid "Pivot Table" +msgstr "Kua Hurihuritia" + +msgid "Pivot operation must include at least one aggregate" +msgstr "Teitei pika o ia raupapa" + +msgid "Pivot operation requires at least one index" +msgstr "Pika" + +msgid "Pivoted" +msgstr "Māmā" + +msgid "Pixel height of each series" +msgstr "Tēnā KAUA e tuhirua i te kī \"filter_scopes\"." + +msgid "Pixels" +msgstr "" +"Tēnā tirohia tō pātai, ā, whakaūngia kua karapotia ngā tawhā tauira katoa e " +"ngā tupua rua, hei tauira, \"{{ ds }}\". Kātahi, whakamātauhia anō tō pātai." + +msgid "Plain" +msgstr "" +"Tēnā tirohia tō pātai mō ngā hapa wetereo i, tata ki \"%(syntax_error)s\" " +"rānei. Kātahi, whakamātauhia anō tō pātai." + +msgid "Please DO NOT overwrite the \"filter_scopes\" key." +msgstr "" +"Tēnā tirohia tō pātai mō ngā hapa wetereo tata ki \"%(server_error)s\". " +"Kātahi, whakamātauhia anō tō pātai." + +msgid "" +"Please check your query and confirm that all template parameters are " +"surround by double braces, for example, \"{{ ds }}\". Then, try running your" +" query again." +msgstr "" +"Tēnā tirohia ō tawhā tauira mō ngā hapa wetereo, ā, kia mārama e hāngai ana " +"puta noa i tō pātai SQL me ngā Tawhā Tautuhi. Kātahi, whakamātauhia anō tō " +"pātai." + +#, python-format +msgid "" +"Please check your query for syntax errors at or near \"%(syntax_error)s\". " +"Then, try running your query again." +msgstr "Tēnā kōwhiria tētahi uara whaimana" + +#, python-format +msgid "" +"Please check your query for syntax errors near \"%(server_error)s\". Then, " +"try running your query again." +msgstr "Tēnā kōwhiria kotahi rōpūmā nui rawa" + +msgid "" +"Please check your template parameters for syntax errors and make sure they " +"match across your SQL query and Set Parameters. Then, try running your query" +" again." +msgstr "Tēnā whakaūngia" + +msgid "Please choose a valid value" +msgstr "Tēnā whakaūngia i ngā uara tuhirua." + +msgid "Please choose at least one groupby" +msgstr "Tēnā kōwhiria kotahi rōpūmā nui rawa" + +msgid "Please confirm" +msgstr "Tēnā whakaūngia" + +msgid "Please confirm the overwrite values." +msgstr "Tēnā whakaūngia i ngā uara tuhirua." + +msgid "Please confirm your password" +msgstr "Tēnā whakaūngia tō kupuhipa" + +msgid "Please enter a SQLAlchemy URI to test" +msgstr "Tēnā tāuru tētahi URI SQLAlchemy hei whakamātau" + +msgid "Please enter a valid email address" +msgstr "Tēnā tāuru tētahi wāhitau īmēra whaimana" + +msgid "Please enter valid text. Spaces alone are not permitted." +msgstr "Tēnā tāuru kupu whaimana. Kāore e whakāetia ngā mokowā anake." + +msgid "Please provide a valid range" +msgstr "Tēnā whakarato he korahi whaimana" + +msgid "Please provide a value within range" +msgstr "Tēnā whakarato he uara i roto i te korahi" + +msgid "Please re-enter the password." +msgstr "Tēnā tāuru anō te kupuhipa." + +msgid "Please re-export your file and try importing again" +msgstr "Tēnā kaweatu-anō tō kōnae, ā, whakamātauhia anō te kawemai" + +msgid "Please reach out to the Chart Owner for assistance." +msgid_plural "Please reach out to the Chart Owners for assistance." +msgstr[0] "Tēnā whakapā atu ki te Rangatira Kauwhata mō te āwhina." +msgstr[1] "Tēnā whakapā atu ki ngā Rangatira Kauwhata mō te āwhina." + +msgid "Please save your chart first, then try creating a new email report." +msgstr "" +"Tēnā tiakihia tō kauwhata i te tuatahi, kātahi ka whakamātau ki te hanga i " +"tētahi pūrongo īmēra hou." + +msgid "" +"Please save your dashboard first, then try creating a new email report." +msgstr "" +"Tēnā tiakihia tō papatohu i te tuatahi, kātahi ka whakamātau ki te hanga i " +"tētahi pūrongo īmēra hou." + +msgid "Please select both a Dataset and a Chart type to proceed" +msgstr "" +"Tēnā tīpakohia he Rārangi Raraunga me tētahi momo Kauwhata hei haere tonu" + +#, python-format +msgid "" +"Please specify the Dataset ID for the ``%(name)s`` metric in the Jinja " +"macro." +msgstr "" +"Tēnā tohua te ID Rārangi Raraunga mō te ine ``%(name)s`` i te macro Jinja." + +msgid "Please use 3 different metric labels" +msgstr "Tēnā whakamahia ngā tapanga ine rerekē e 3" + +msgid "Plot the distance (like flight paths) between origin and destination." +msgstr "" +"Whakatakoto i te tawhiti (pērā i ngā ara rererangi) i waenga i te puna me te" +" wāhi tae." + +msgid "" +"Plots the individual metrics for each row in the data vertically and links " +"them together as a line. This chart is useful for comparing multiple metrics" +" across all of the samples or rows in the data." +msgstr "" +"Ka whakatakoto i ngā ine takitahi mō ia rārangi i ngā raraunga poutū, ā, ka " +"hono hei rārangi. He whaihua tēnei kauwhata mō te whakatairite i ngā ine " +"maha puta noa i ngā tauira, i ngā rārangi katoa rānei i roto i ngā raraunga." + +msgid "Plugins" +msgstr "Mono" + +msgid "Point Color" +msgstr "Tae Tohu" + +msgid "Point Radius" +msgstr "Pūtoro Tohu" + +msgid "Point Radius Scale" +msgstr "Tauine Pūtoro Tohu" + +msgid "Point Radius Unit" +msgstr "Waeine Pūtoro Tohu" + +msgid "Point Size" +msgstr "Rahi Tohu" + +msgid "Point Unit" +msgstr "Waeine Tohu" + +msgid "Point to your spatial columns" +msgstr "Tohu ki ō tīwae tauwāhi" + +msgid "Points" +msgstr "Tohu" + +msgid "Points and clusters will update as the viewport is being changed" +msgstr "Ka whakahouhia ngā tohu me ngā rāpaki i te huringa o te tirohanga" + +msgid "Polygon Column" +msgstr "Tīwae Tapawhā" + +msgid "Polygon Encoding" +msgstr "Whakakohu Tapawhā" + +msgid "Polygon Settings" +msgstr "Tautuhinga Tapawhā" + +msgid "Polyline" +msgstr "Rārangi-maha" + +msgid "Populate \"Default value\" to enable this control" +msgstr "Whakakīa \"Uara taunoa\" hei whakahohe i tēnei whakahaere" + +msgid "Port" +msgstr "Tauranga" + +#, python-format +msgid "Port %(port)s on hostname \"%(hostname)s\" refused the connection." +msgstr "" +"I whakakore te tauranga %(port)s i te ingoa tūmau \"%(hostname)s\" i te " +"hononga." + +msgid "Port out of range 0-65535" +msgstr "Tauranga i waho o te korahi 0-65535" + +msgid "Position JSON" +msgstr "Tūnga JSON" + +msgid "Position of child node label on tree" +msgstr "Tūnga tapanga pona tamaiti i te rākau" + +msgid "Position of column level subtotal" +msgstr "Tūnga tapeke taumata tīwae" + +msgid "Position of intermediate node label on tree" +msgstr "Tūnga tapanga pona waenganui i te rākau" + +msgid "Position of row level subtotal" +msgstr "Tūnga tapeke taumata rārangi" + +msgid "Powered by Apache Superset" +msgstr "Ka whakamana e Apache Superset" + +msgid "Pre-filter" +msgstr "Tātari-i-mua" + +msgid "Pre-filter available values" +msgstr "Uara wātea tātari-i-mua" + +msgid "Pre-filter is required" +msgstr "E hiahiatia ana te tātari-i-mua" + +msgid "Predictive" +msgstr "Matapae" + +msgid "Predictive Analytics" +msgstr "Tātaritanga Matapae" + +msgid "Prefix" +msgstr "Kūmua" + +msgid "Prefix or suffix" +msgstr "Kūmua, kūmuri rānei" + +msgid "Preview" +msgstr "Arokite" + +msgid "Preview uploaded file" +msgstr "Arokite kōnae kua tukuaketia" + +msgid "Previous" +msgstr "Tōmua" + +msgid "Previous Line" +msgstr "Rārangi Tōmua" + +msgid "Primary" +msgstr "Matua" + +msgid "Primary Metric" +msgstr "Ine Matua" + +msgid "Primary key" +msgstr "Kī matua" + +msgid "Primary or secondary y-axis" +msgstr "Tukutuku-y matua, tuarua rānei" + +msgid "Primary y-axis Bounds" +msgstr "Rohe tukutuku-y Matua" + +msgid "Primary y-axis format" +msgstr "Hōputu tukutuku-y matua" + +msgid "Private Channels (Bot in channel)" +msgstr "Hongere Matawhā (Bot i te hongere)" + +msgid "Private Key" +msgstr "Kī Matawhā" + +msgid "Private Key & Password" +msgstr "Kī Matawhā me te Kupuhipa" + +msgid "Private Key Password" +msgstr "Kupuhipa Kī Matawhā" + +msgid "Proceed" +msgstr "Haere tonu" + +msgid "Progress" +msgstr "Kokenga" + +msgid "Progressive" +msgstr "Kokenga" + +msgid "Project Id" +msgstr "ID Kaupapa" + +msgid "Proportional" +msgstr "Tauōrite" + +msgid "Published" +msgstr "Kua Whakaputaina" + +msgid "Purple" +msgstr "Waiporoporo" + +msgid "Put labels outside" +msgstr "Whakatū tapanga ki waho" + +msgid "Put positive values and valid minute and second value less than 60" +msgstr "" +"Whakatū uara pai me te uara meneti me te hēkona whaimana iti ake i te 60" + +msgid "Put some positive value greater than 0" +msgstr "Whakatū uara pai nui ake i te 0" + +msgid "Put the labels outside of the pie?" +msgstr "Whakatū i ngā tapanga ki waho o te pai?" + +msgid "Put your code here" +msgstr "Whakatū tō waehere ki konei" + +msgid "Python datetime string pattern" +msgstr "Tauira aho datetime Python" + +msgid "QUERY DATA IN SQL LAB" +msgstr "PĀTAI RARAUNGA I SQL LAB" + +msgid "Quarter" +msgstr "Hautakiwā" + +#, python-format +msgid "Quarters %s" +msgstr "Hautakiwā %s" + +msgid "Queries" +msgstr "Pātai" + +msgid "Query" +msgstr "Pātai" + +#, python-format +msgid "Query %s: %s" +msgstr "Pātai %s: %s" + +msgid "Query A" +msgstr "Pātai A" + +msgid "Query B" +msgstr "Pātai B" + +msgid "Query History" +msgstr "Hītori Pātai" + +msgid "Query does not exist" +msgstr "Karekau te pātai" + +msgid "Query history" +msgstr "Hītori pātai" + +msgid "Query imported" +msgstr "Pātai kua kawemaihia" + +msgid "Query in a new tab" +msgstr "Pātai i tētahi ripa hou" + +msgid "Query is too complex and takes too long to run." +msgstr "He uaua rawa te pātai, ā, he roa rawa te wā hei rere." + +msgid "Query mode" +msgstr "Aratau pātai" + +msgid "Query name" +msgstr "Ingoa pātai" + +msgid "Query preview" +msgstr "Arokite pātai" + +msgid "Query was stopped" +msgstr "I whakamutua te pātai" + +msgid "Query was stopped." +msgstr "I whakamutua te pātai." + +msgid "RANGE TYPE" +msgstr "MOMO AWHE" + +msgid "RGB Color" +msgstr "Tae RGB" + +msgid "RLS Rule not found." +msgstr "Kāore i kitea te Ture RLS." + +msgid "RLS rules could not be deleted." +msgstr "Kāore i taea te muku i ngā ture RLS." + +msgid "Radar" +msgstr "Whakarapa" + +msgid "Radar Chart" +msgstr "Kauwhata Whakarapa" + +msgid "Radar render type, whether to display 'circle' shape." +msgstr "Momo whakaatu whakarapa, mēnā ka whakaatu i te hanga 'porohita'." + +msgid "Radial" +msgstr "Raupapa" + +msgid "Radius" +msgstr "Pūtoro" + +msgid "Radius in kilometers" +msgstr "Pūtoro i ngā kiromita" + +msgid "Radius in meters" +msgstr "Pūtoro i ngā mita" + +msgid "Radius in miles" +msgstr "Pūtoro i ngā maero" + +msgid "Range" +msgstr "Korahi" + +msgid "Range filter" +msgstr "Tātari korahi" + +msgid "Range filter plugin using AntD" +msgstr "Mono tātari korahi mā te AntD" + +msgid "Range labels" +msgstr "Tapanga korahi" + +msgid "Ranges" +msgstr "Korahi" + +msgid "Ranges to highlight with shading" +msgstr "Korahi hei whakamiramira ki te marumaru" + +msgid "Ranking" +msgstr "Kōmaka" + +msgid "Ratio" +msgstr "Ōwehenga" + +msgid "Raw records" +msgstr "Rekoata mata" + +msgid "Recently modified" +msgstr "I whakarerekeahia tata nei" + +msgid "Recents" +msgstr "Tata nei" + +msgid "Recipients are separated by \",\" or \";\"" +msgstr "Ka wehea ngā kaiwhakawhiti mā te \",\" mā te \";\" rānei" + +msgid "Record Count" +msgstr "Tatau Rekoata" + +msgid "Rectangle" +msgstr "Tapawhā Rite" + +msgid "Recurring (every)" +msgstr "Auau tonu (ia)" + +msgid "Red for increase, green for decrease" +msgstr "Whero mō te piki, kākāriki mō te heke" + +msgid "Redo the action" +msgstr "Mahia anō te mahi" + +msgid "Reduce X ticks" +msgstr "Whakaiti i ngā tika X" + +msgid "" +"Reduces the number of X-axis ticks to be rendered. If true, the x-axis will " +"not overflow and labels may be missing. If false, a minimum width will be " +"applied to columns and the width may overflow into an horizontal scroll." +msgstr "" +"Ka whakaiti i te maha o ngā tika tukutuku-X ka whakaaturia. Mēnā he pono, " +"karekau te tukutuku-x e puare, ā, ka ngaro pea ngā tapanga. Mēnā he hē, ka " +"whakahaeretia te whānui iti ki ngā tīwae, ā, ka taea pea e te whānui te " +"puare ki tētahi takahuri whakapae." + +msgid "Refer to the" +msgstr "Tirohia te" + +msgid "Referenced columns not available in DataFrame." +msgstr "Kāore i wātea ngā tīwae tohutoro i te DataFrame." + +msgid "Refetch results" +msgstr "Tikihia anō ngā hua" + +msgid "Refresh" +msgstr "Whakahou" + +msgid "Refresh dashboard" +msgstr "Whakahou papatohu" + +msgid "Refresh frequency" +msgstr "Auau whakahou" + +msgid "Refresh interval" +msgstr "Wā whakahou" + +msgid "Refresh interval saved" +msgstr "Wā whakahou kua tiakina" + +msgid "Refresh table schema" +msgstr "Whakahou hanga pātengi raraunga" + +msgid "Refresh the default values" +msgstr "Whakahou i ngā uara taunoa" + +msgid "Refreshing charts" +msgstr "E whakahou ana i ngā kauwhata" + +msgid "Refreshing columns" +msgstr "E whakahou ana i ngā tīwae" + +msgid "Regular" +msgstr "Auau" + +msgid "" +"Regular filters add where clauses to queries if a user belongs to a role " +"referenced in the filter, base filters apply filters to all queries except " +"the roles defined in the filter, and can be used to define what users can " +"see if no RLS filters within a filter group apply to them." +msgstr "" +"Ka tāpiri ngā tātari auau i ngā rerenga kei hea ki ngā pātai mēnā nō tētahi " +"tūranga te kaiwhakamahi kua tohutorohia i te tātari, ka whakahaeretia ngā " +"tātari pūtake ki ngā pātai katoa haunga ngā tūranga kua tautuhia i te " +"tātari, ā, ka taea te whakamahi hei tautuhi i ngā mea ka taea e ngā " +"kaiwhakamahi te kite mēnā karekau he tātari RLS i roto i tētahi rōpū tātari " +"e pā ana ki a rātou." + +msgid "Relational" +msgstr "Hononga" + +msgid "Relationships between community channels" +msgstr "Hononga i waenga i ngā hongere hapori" + +msgid "Relative Date/Time" +msgstr "Rā/Wā Tata" + +msgid "Relative period" +msgstr "Wā tata" + +msgid "Relative quantity" +msgstr "Rahinga tata" + +msgid "Reload" +msgstr "Uta-anō" + +msgid "Remove" +msgstr "Tango" + +msgid "Remove cross-filter" +msgstr "Tango tātari-whiti" + +msgid "Remove item" +msgstr "Tango mea" + +msgid "Remove query from log" +msgstr "Tango pātai mai i te rārangi" + +msgid "Remove table preview" +msgstr "Tango arokite ripanga" + +#, python-format +msgid "Removed 1 column from the virtual dataset" +msgid_plural "Removed %s columns from the virtual dataset" +msgstr[0] "Kua tangohia 1 tīwae mai i te rārangi raraunga mariko" +msgstr[1] "Kua tangohia %s tīwae mai i te rārangi raraunga mariko" + +msgid "Rename tab" +msgstr "Tapa ingoa-anō ripa" + +msgid "Render HTML" +msgstr "Whakaatu HTML" + +msgid "Render columns in HTML format" +msgstr "Whakaatu tīwae i te hōputu HTML" + +msgid "" +"Renders table cells as HTML when applicable. For example, HTML tags will" +" be rendered as hyperlinks." +msgstr "" +"Ka whakaatu i ngā pūtau ripanga hei HTML ina tika. Hei tauira, ka " +"whakaaturia ngā tohu HTML hei honohono." + +msgid "Replace" +msgstr "Whakakapi" + +msgid "Report" +msgstr "Pūrongo" + +msgid "Report Name" +msgstr "Ingoa Pūrongo" + +msgid "Report Schedule could not be created." +msgstr "Kāore i taea te hanga i te Hōtaka Pūrongo." + +msgid "Report Schedule could not be updated." +msgstr "Kāore i taea te whakahou i te Hōtaka Pūrongo." + +msgid "Report Schedule delete failed." +msgstr "I rahua te muku i te Hōtaka Pūrongo." + +msgid "Report Schedule execution failed when generating a csv." +msgstr "" +"I rahua te whakatutukitanga o te Hōtaka Pūrongo i te hangarautanga o tētahi " +"csv." + +msgid "Report Schedule execution failed when generating a dataframe." +msgstr "" +"I rahua te whakatutukitanga o te Hōtaka Pūrongo i te hangarautanga o tētahi " +"dataframe." + +msgid "Report Schedule execution failed when generating a pdf." +msgstr "" +"I rahua te whakatutukitanga o te Hōtaka Pūrongo i te hangarautanga o tētahi " +"pdf." + +msgid "Report Schedule execution failed when generating a screenshot." +msgstr "" +"I rahua te whakatutukitanga o te Hōtaka Pūrongo i te hangarautanga o tētahi " +"hopuataata." + +msgid "Report Schedule execution got an unexpected error." +msgstr "I puta tētahi hapa ohorere i te whakatutukitanga o te Hōtaka Pūrongo." + +msgid "Report Schedule is still working, refusing to re-compute." +msgstr "Kei te mahi tonu te Hōtaka Pūrongo, e whakakore ana ki te tatau-anō." + +msgid "Report Schedule log prune failed." +msgstr "I rahua te pure rārangi Hōtaka Pūrongo." + +msgid "Report Schedule not found." +msgstr "Kāore i kitea te Hōtaka Pūrongo." + +msgid "Report Schedule parameters are invalid." +msgstr "He muhu ngā tawhā Hōtaka Pūrongo." + +msgid "Report Schedule reached a working timeout." +msgstr "I tae te Hōtaka Pūrongo ki tētahi wā-pau mahi." + +msgid "Report Schedule state not found" +msgstr "Kāore i kitea te tūnga Hōtaka Pūrongo" + +msgid "Report a bug" +msgstr "Pūrongo hapa" + +msgid "Report contents" +msgstr "Ihirangi pūrongo" + +msgid "Report failed" +msgstr "I rahua te pūrongo" + +msgid "Report is active" +msgstr "Kei te hohe te pūrongo" + +msgid "Report name" +msgstr "Ingoa pūrongo" + +msgid "Report schedule client error" +msgstr "Hapa kiritaki hōtaka pūrongo" + +msgid "Report schedule system error" +msgstr "Hapa pūnaha hōtaka pūrongo" + +msgid "Report schedule unexpected error" +msgstr "Hapa ohorere hōtaka pūrongo" + +msgid "Report sending" +msgstr "E tuku ana i te pūrongo" + +msgid "Report sent" +msgstr "Pūrongo kua tukuna" + +msgid "Report updated" +msgstr "Pūrongo kua whakahouhia" + +msgid "Reports" +msgstr "Pūrongo" + +msgid "Repulsion" +msgstr "Panapana" + +msgid "Repulsion strength between nodes" +msgstr "Kaha panapana i waenga i ngā pona" + +msgid "Request Access" +msgstr "Tono Urunga" + +#, python-format +msgid "Request is incorrect: %(error)s" +msgstr "He hē te tono: %(error)s" + +msgid "Request is not JSON" +msgstr "Ehara i te JSON te tono" + +msgid "Request missing data field." +msgstr "Kei te ngaro te āpure raraunga o te tono." + +msgid "Request timed out" +msgstr "Wā-pau tono" + +msgid "Required" +msgstr "E Hiahiatia Ana" + +msgid "Required control values have been removed" +msgstr "Kua tangohia ngā uara whakahaere e hiahiatia ana" + +msgid "Resample" +msgstr "Tauira-anō" + +msgid "Resample method should be in " +msgstr "Me noho te tikanga tauira-anō i" + +msgid "Resample operation requires DatetimeIndex" +msgstr "E hiahiatia ana te DatetimeIndex mō te mahinga tauira-anō" + +msgid "Reset" +msgstr "Tautuhi anō" + +msgid "Reset columns" +msgstr "Tautuhi anō i ngā tīwae" + +msgid "Reset state" +msgstr "Tautuhi anō i te tūnga" + +msgid "Resource already has an attached report." +msgstr "Kua tāpiritia kētia he pūrongo ki te rauemi." + +msgid "Resource was not found." +msgstr "Kāore i kitea te rauemi." + +msgid "Restore filter" +msgstr "Whakaora tātari" + +msgid "Results" +msgstr "Hua" + +#, python-format +msgid "Results %s" +msgstr "Hua %s" + +msgid "Results backend is not configured." +msgstr "Kāore i whirihorahia te tuarongo hua." + +msgid "Results backend needed for asynchronous queries is not configured." +msgstr "" +"E hiahiatia ana te tuarongo hua mō ngā pātai kore-hangarite, engari kāore i " +"whirihorahia." + +msgid "Retry fetching results" +msgstr "Whakamātau anō te tiki i ngā hua" + +msgid "Return to specific datetime." +msgstr "Hoki ki te datetime motuhake." + +msgid "Reverse Lat & Long" +msgstr "Whakahuri Lat me Long" + +msgid "Reverse lat/long " +msgstr "Whakahuri lat/long " + +msgid "Rich Tooltip" +msgstr "Kītukutuku Whai Rawa" + +msgid "Rich tooltip" +msgstr "Kītukutuku whai rawa" + +msgid "Right" +msgstr "Matau" + +msgid "Right Axis Format" +msgstr "Hōputu Tukutuku Matau" + +msgid "Right Axis Metric" +msgstr "Ine Tukutuku Matau" + +msgid "Right axis metric" +msgstr "Ine tukutuku matau" + +msgid "Right to Left" +msgstr "Matau ki Mauī" + +msgid "Right value" +msgstr "Uara matau" + +msgid "Right-click on a dimension value to drill to detail by that value." +msgstr "" +"Pāwhiri-matau i runga i tētahi uara āhuahanga hei keri ki te taipitopito mā " +"taua uara." + +msgid "Role" +msgstr "Tūranga" + +msgid "Role Name" +msgstr "Ingoa Tūranga" + +msgid "Role is required" +msgstr "E hiahiatia ana te tūranga" + +msgid "Role name is required" +msgstr "E hiahiatia ana te ingoa tūranga" + +msgid "Role successfully updated!" +msgstr "I angitu te whakahou i te tūranga!" + +msgid "Role was successfully created!" +msgstr "I angitu te hanganga o te tūranga!" + +msgid "Role was successfully duplicated!" +msgstr "I angitu te tāruatanga o te tūranga!" + +msgid "Roles" +msgstr "Tūranga" + +msgid "" +"Roles is a list which defines access to the dashboard. Granting a role " +"access to a dashboard will bypass dataset level checks. If no roles are " +"defined, regular access permissions apply." +msgstr "" +"He rārangi te Tūranga e tautuhi ana i te urunga ki te papatohu. Mā te tuku i" +" te urunga tūranga ki tētahi papatohu ka poke i ngā tirotiro taumata rārangi" +" raraunga. Mēnā karekau he tūranga kua tautuhia, ka pā ngā mōtika urunga " +"auau." + +msgid "" +"Roles is a list which defines access to the dashboard. Granting a role " +"access to a dashboard will bypass dataset level checks.If no roles are " +"defined, regular access permissions apply." +msgstr "" +"He rārangi te Tūranga e tautuhi ana i te urunga ki te papatohu. Mā te tuku i" +" te urunga tūranga ki tētahi papatohu ka poke i ngā tirotiro taumata rārangi" +" raraunga. Mēnā karekau he tūranga kua tautuhia, ka pā ngā mōtika urunga " +"auau." + +msgid "Rolling Function" +msgstr "Taumahi Takahuri" + +msgid "Rolling Window" +msgstr "Matapihi Takahuri" + +msgid "Rolling function" +msgstr "Taumahi takahuri" + +msgid "Rolling window" +msgstr "Matapihi takahuri" + +msgid "Root certificate" +msgstr "Tiwhikete pūtake" + +msgid "Root node id" +msgstr "Id pona pūtake" + +msgid "Rose Type" +msgstr "Momo Rose" + +msgid "Rotate x axis label" +msgstr "Hurihuri tapanga tukutuku x" + +msgid "Rotate y axis label" +msgstr "Hurihuri tapanga tukutuku y" + +msgid "Rotation to apply to words in the cloud" +msgstr "Hurihuri hei whakahaeretia ki ngā kupu i te kapua" + +msgid "Round cap" +msgstr "Potae porohita" + +msgid "Row" +msgstr "Rārangi" + +msgid "Row Level Security" +msgstr "Haumaru Taumata Rārangi" + +msgid "" +"Row containing the headers to use as column names (0 is first line of data)." +msgstr "" +"Rārangi kei roto ngā pane hei whakamahi hei ingoa tīwae (0 ko te rārangi " +"tuatahi o ngā raraunga)." + +msgid "Row limit" +msgstr "Tepe rārangi" + +msgid "Rows" +msgstr "Rārangi" + +msgid "Rows per page, 0 means no pagination" +msgstr "Rārangi ia whārangi, 0 karekau he whārangitanga" + +msgid "Rows subtotal position" +msgstr "Tūnga tapeke-iti rārangi" + +msgid "Rows to read" +msgstr "Rārangi hei pānui" + +msgid "Rule" +msgstr "Ture" + +msgid "Rule Name" +msgstr "Ingoa Ture" + +msgid "Rule added" +msgstr "Ture kua tāpiritia" + +msgid "Run" +msgstr "Whakahaere" + +msgid "Run a query to display query history" +msgstr "Whakahaere pātai hei whakaatu i te hītori pātai" + +msgid "Run a query to display results" +msgstr "Whakahaere pātai hei whakaatu i ngā hua" + +msgid "Run current query" +msgstr "Whakahaere pātai o nāianei" + +msgid "Run in SQL Lab" +msgstr "Whakahaere i SQL Lab" + +msgid "Run query" +msgstr "Whakahaere pātai" + +msgid "Run query (Ctrl + Return)" +msgstr "Whakahaere pātai (Ctrl + Return)" + +msgid "Run query in a new tab" +msgstr "Whakahaere pātai i tētahi ripa hou" + +msgid "Run selection" +msgstr "Whakahaere tīpakonga" + +msgid "Running" +msgstr "E Rere Ana" + +#, python-format +msgid "Running statement %(statement_num)s out of %(statement_count)s" +msgstr "" +"E whakahaere ana i te kīanga %(statement_num)s i waho o %(statement_count)s" + +msgid "SAT" +msgstr "HĀT" + +msgid "SECOND" +msgstr "HĒKONA" + +msgid "SEP" +msgstr "MAH" + +msgid "SHA" +msgstr "SHA" + +msgid "SQL" +msgstr "SQL" + +msgid "SQL Copied!" +msgstr "SQL Kua Tāruahia!" + +msgid "SQL Lab" +msgstr "SQL Lab" + +msgid "SQL Lab queries" +msgstr "Pātai SQL Lab" + +#, python-format +msgid "" +"SQL Lab uses your browser's local storage to store queries and results.\n" +"Currently, you are using %(currentUsage)s KB out of %(maxStorage)d KB storage space.\n" +"To keep SQL Lab from crashing, please delete some query tabs.\n" +"You can re-access these queries by using the Save feature before you delete the tab.\n" +"Note that you will need to close other SQL Lab windows before you do this." +msgstr "" +"Ka whakamahi SQL Lab i te rokiroki ā-rohe o tō pūtirotiro hei penapena i ngā" +" pātai me ngā hua." + +msgid "SQL Query" +msgstr "Pātai SQL" + +msgid "SQL expression" +msgstr "Kīanga SQL" + +msgid "SQL query" +msgstr "Pātai SQL" + +msgid "SQLAlchemy URI" +msgstr "URI SQLAlchemy" + +msgid "SSH Host" +msgstr "Tūmau SSH" + +msgid "SSH Password" +msgstr "Kupuhipa SSH" + +msgid "SSH Port" +msgstr "Tauranga SSH" + +msgid "SSH Tunnel" +msgstr "Pūaha SSH" + +msgid "SSH Tunnel configuration parameters" +msgstr "Tawhā whirihora Pūaha SSH" + +msgid "SSH Tunnel could not be deleted." +msgstr "Kāore i taea te muku i te Pūaha SSH." + +msgid "SSH Tunnel could not be updated." +msgstr "Kāore i taea te whakahou i te Pūaha SSH." + +msgid "SSH Tunnel not found." +msgstr "Kāore i kitea te Pūaha SSH." + +msgid "SSH Tunnel parameters are invalid." +msgstr "He muhu ngā tawhā Pūaha SSH." + +msgid "SSH Tunneling is not enabled" +msgstr "Kāore i whakahohengia te Pūaha SSH" + +msgid "SSL Mode \"require\" will be used." +msgstr "Ka whakamahia te Aratau SSL \"require\"." + +msgid "START (INCLUSIVE)" +msgstr "TĪMATA (WHĀITI)" + +#, python-format +msgid "STEP %(stepCurr)s OF %(stepLast)s" +msgstr "TAKAHANGA %(stepCurr)s O %(stepLast)s" + +msgid "STRING" +msgstr "AHO" + +msgid "SUN" +msgstr "RĀT" + +msgid "Sample Standard Deviation" +msgstr "Rerekētanga Paerewa Tauira" + +msgid "Sample Variance" +msgstr "Rerekētanga Tauira" + +msgid "Samples" +msgstr "Tauira" + +msgid "Samples for dataset could not be retrieved." +msgstr "Kāore i taea te tiki i ngā tauira mō te rārangi raraunga." + +msgid "Samples for datasource could not be retrieved." +msgstr "Kāore i taea te tiki i ngā tauira mō te puna raraunga." + +msgid "Sankey Chart" +msgstr "Kauwhata Sankey" + +msgid "Satellite" +msgstr "Āmiorangi" + +msgid "Satellite Streets" +msgstr "Āmiorangi Tiriti" + +msgid "Saturday" +msgstr "Hātarei" + +msgid "Save" +msgstr "Tiaki" + +msgid "Save & Explore" +msgstr "Tiaki & Tūhura" + +msgid "Save & go to dashboard" +msgstr "Tiaki & haere ki te papatohu" + +msgid "Save (Overwrite)" +msgstr "Tiaki (Tuhirua)" + +msgid "Save as" +msgstr "Tiaki hei" + +msgid "Save as Dataset" +msgstr "Tiaki hei Rārangi Raraunga" + +msgid "Save as dataset" +msgstr "Tiaki hei rārangi raraunga" + +msgid "Save as new" +msgstr "Tiaki hei hou" + +msgid "Save as..." +msgstr "Tiaki hei..." + +msgid "Save as:" +msgstr "Tiaki hei:" + +msgid "Save changes" +msgstr "Tiaki huringa" + +msgid "Save chart" +msgstr "Tiaki kauwhata" + +msgid "Save dashboard" +msgstr "Tiaki papatohu" + +msgid "Save dataset" +msgstr "Tiaki rārangi raraunga" + +msgid "Save for this session" +msgstr "Tiaki mō tēnei wātaka" + +msgid "Save or Overwrite Dataset" +msgstr "Tiaki, Tuhirua rānei i te Rārangi Raraunga" + +msgid "Save query" +msgstr "Tiaki pātai" + +msgid "Save this query as a virtual dataset to continue exploring" +msgstr "" +"Tiakihia tēnei pātai hei rārangi raraunga mariko hei haere tonu i te " +"tūhuratanga" + +msgid "Saved" +msgstr "Kua Tiakina" + +msgid "Saved Queries" +msgstr "Pātai Kua Tiakina" + +msgid "Saved expressions" +msgstr "Kīanga kua tiakina" + +msgid "Saved metric" +msgstr "Ine kua tiakina" + +msgid "Saved queries" +msgstr "Pātai kua tiakina" + +msgid "Saved queries could not be deleted." +msgstr "Kāore i taea te muku i ngā pātai kua tiakina." + +msgid "Saved query not found." +msgstr "Kāore i kitea te pātai kua tiakina." + +msgid "Saved query parameters are invalid." +msgstr "He muhu ngā tawhā pātai kua tiakina." + +msgid "Saving..." +msgstr "E tiaki ana..." + +msgid "Scale and Move" +msgstr "Tauine me te Neke" + +msgid "Scale only" +msgstr "Tauine anake" + +msgid "Scatter" +msgstr "Marara" + +msgid "Scatter Plot" +msgstr "Kauwhata Marara" + +msgid "" +"Scatter Plot has the horizontal axis in linear units, and the points are " +"connected in order. It shows a statistical relationship between two " +"variables." +msgstr "" +"He tukutuku whakapae waeine rārangi tō te Kauwhata Marara, ā, ka honoa ngā " +"tohu i te raupapa. Ka whakaatu i tētahi hononga tauanga i waenga i ngā " +"taurangi e rua." + +msgid "Schedule" +msgstr "Hōtaka" + +msgid "Schedule a new email report" +msgstr "Hōtaka pūrongo īmēra hou" + +msgid "Schedule email report" +msgstr "Hōtaka pūrongo īmēra" + +msgid "Schedule query" +msgstr "Hōtaka pātai" + +msgid "Schedule the query periodically" +msgstr "Hōtaka i te pātai wā auau" + +msgid "Schedule type" +msgstr "Momo hōtaka" + +msgid "Scheduled" +msgstr "Kua Hōtakahia" + +msgid "Scheduled at (UTC)" +msgstr "Kua hōtakahia i (UTC)" + +msgid "Scheduled task executor not found" +msgstr "Kāore i kitea te kaiwhakatutuki tūmahi hōtaka" + +msgid "Schema" +msgstr "Hanga" + +msgid "Schema cache timeout" +msgstr "Wā kore-mahi keteroki hanga" + +msgid "Schemas allowed for File upload" +msgstr "Hanga e whakāetia ana mō te tukuake kōnae" + +msgid "Scope" +msgstr "Korahi" + +msgid "Scoping" +msgstr "Korahi" + +msgid "Screenshot width" +msgstr "Whānui hopuataata" + +#, python-format +msgid "Screenshot width must be between %(min)spx and %(max)spx" +msgstr "Me noho te whānui hopuataata i waenga i %(min)spx me %(max)spx" + +msgid "Scroll" +msgstr "Takahuri" + +msgid "Scroll down to the bottom to enable overwriting changes. " +msgstr "" +"Takahuri ki raro ki te wāhi raro hei whakahohe i te tuhirua i ngā huringa. " + +msgid "Search" +msgstr "Rapu" + +#, python-format +msgid "Search %s records" +msgstr "Rapu %s rekoata" + +msgid "Search / Filter" +msgstr "Rapu / Tātari" + +msgid "Search Metrics & Columns" +msgstr "Rapu Ine me ngā Tīwae" + +msgid "Search all charts" +msgstr "Rapu i ngā kauwhata katoa" + +msgid "Search box" +msgstr "Pouaka rapu" + +msgid "Search by query text" +msgstr "Rapu mā te kupu pātai" + +msgid "Search columns" +msgstr "Rapu tīwae" + +msgid "Search in filters" +msgstr "Rapu i ngā tātari" + +msgid "Search..." +msgstr "Rapu..." + +msgid "Second" +msgstr "Hēkona" + +msgid "Secondary" +msgstr "Tuarua" + +msgid "Secondary Metric" +msgstr "Ine Tuarua" + +msgid "Secondary currency format" +msgstr "Hōputu moni tuarua" + +msgid "Secondary y-axis Bounds" +msgstr "Rohe tukutuku-y Tuarua" + +msgid "Secondary y-axis format" +msgstr "Hōputu tukutuku-y tuarua" + +msgid "Secondary y-axis title" +msgstr "Taitara tukutuku-y tuarua" + +#, python-format +msgid "Seconds %s" +msgstr "Hēkona %s" + +msgid "Seconds value" +msgstr "Uara hēkona" + +msgid "Secure extra" +msgstr "Taapiri haumaru" + +msgid "Security" +msgstr "Haumaru" + +#, python-format +msgid "See all %(tableName)s" +msgstr "Tirohia ngā %(tableName)s katoa" + +msgid "See less" +msgstr "Tirohia te iti ake" + +msgid "See more" +msgstr "Tirohia te nui ake" + +msgid "See query details" +msgstr "Tirohia ngā taipitopito pātai" + +msgid "See table schema" +msgstr "Tirohia te hanga ripanga" + +msgid "Select" +msgstr "Tīpako" + +msgid "Select ..." +msgstr "Tīpako ..." + +msgid "Select Delivery Method" +msgstr "Tīpako Tikanga Tuku" + +msgid "Select Tags" +msgstr "Tīpako Tohu" + +msgid "Select chart type" +msgstr "Tīpako momo kauwhata" + +msgid "Select a column" +msgstr "Tīpakohia tētahi tīwae" + +msgid "Select a dashboard" +msgstr "Tīpakohia tētahi papatohu" + +msgid "Select a database" +msgstr "Tīpakohia tētahi pātengi raraunga" + +msgid "Select a database table and create dataset" +msgstr "" +"Tīpakohia tētahi ripanga pātengi raraunga, ā, hangaia te rārangi raraunga" + +msgid "Select a database table." +msgstr "Tīpakohia tētahi ripanga pātengi raraunga." + +msgid "Select a database to connect" +msgstr "Tīpakohia tētahi pātengi raraunga hei hono" + +msgid "Select a database to upload the file to" +msgstr "Tīpakohia tētahi pātengi raraunga hei tukuake i te kōnae" + +msgid "Select a database to write a query" +msgstr "Tīpakohia tētahi pātengi raraunga hei tuhi i tētahi pātai" + +msgid "Select a dataset" +msgstr "Tīpakohia tētahi rārangi raraunga" + +msgid "Select a delimiter for this data" +msgstr "Tīpakohia tētahi tohutuhi mō ēnei raraunga" + +msgid "Select a dimension" +msgstr "Tīpakohia tētahi āhuahanga" + +msgid "Select a metric to display on the right axis" +msgstr "Tīpakohia tētahi ine hei whakaatu i te tukutuku matau" + +msgid "" +"Select a metric to display. You can use an aggregation function on a column " +"or write custom SQL to create a metric." +msgstr "" +"Tīpakohia tētahi ine hei whakaatu. Ka taea e koe te whakamahi i tētahi " +"taumahi whakaarotau i runga i tētahi tīwae, te tuhi SQL ritenga rānei hei " +"hanga i tētahi ine." + +msgid "Select a schema" +msgstr "Tīpakohia tētahi hanga" + +msgid "Select a schema if the database supports this" +msgstr "Tīpakohia he hanga mēnā e tautoko ana te pātengi raraunga" + +msgid "Select a sheet name from the uploaded file" +msgstr "Tīpakohia he ingoa hīti mai i te kōnae kua tukuaketia" + +msgid "Select a tab" +msgstr "Tīpakohia he ripa" + +msgid "" +"Select a time grain for the visualization. The grain is the time interval " +"represented by a single point on the chart." +msgstr "" +"Tīpakohia he māeneene wā mō te whakakitenga. Ko te māeneene te wā wā e tohua" +" ana e tētahi tohu kotahi i te kauwhata." + +msgid "Select a visualization type" +msgstr "Tīpakohia he momo whakakitenga" + +msgid "Select aggregate options" +msgstr "Tīpakohia ngā kōwhiringa whakaarotau" + +msgid "Select all data" +msgstr "Tīpakohia ngā raraunga katoa" + +msgid "Select all items" +msgstr "Tīpakohia ngā mea katoa" + +msgid "Select an aggregation method to apply to the metric." +msgstr "Tīpakohia he tikanga whakaarotau hei whakahaeretia ki te ine." + +msgid "Select catalog or type to search catalogs" +msgstr "Tīpakohia kātaloka, pato rānei hei rapu kātaloka" + +msgid "Select channels" +msgstr "Tīpakohia hongere" + +msgid "Select chart" +msgstr "Tīpakohia kauwhata" + +msgid "Select chart to use" +msgstr "Tīpakohia kauwhata hei whakamahi" + +msgid "Select charts" +msgstr "Tīpakohia kauwhata" + +msgid "Select color scheme" +msgstr "Tīpakohia kaupapa tae" + +msgid "Select column" +msgstr "Tīpakohia tīwae" + +msgid "" +"Select column names from a dropdown list that should be parsed as dates." +msgstr "" +"Tīpakohia ingoa tīwae mai i tētahi rārangi taka iho me poroporo hei rā." + +msgid "" +"Select columns that will be displayed in the table. You can multiselect " +"columns." +msgstr "" +"Tīpakohia ngā tīwae ka whakaaturia i te ripanga. Ka taea e koe te tīpako-" +"maha i ngā tīwae." + +msgid "Select content type" +msgstr "Tīpakohia momo ihirangi" + +msgid "Select current page" +msgstr "Tīpakohia whārangi o nāianei" + +msgid "Select dashboard" +msgstr "Tīpakohia papatohu" + +msgid "Select dashboard to use" +msgstr "Tīpakohia papatohu hei whakamahi" + +msgid "Select dashboards" +msgstr "Tīpakohia papatohu" + +msgid "Select database" +msgstr "Tīpakohia pātengi raraunga" + +msgid "Select database or type to search databases" +msgstr "Tīpakohia pātengi raraunga, pato rānei hei rapu pātengi raraunga" + +msgid "" +"Select databases require additional fields to be completed in the Advanced " +"tab to successfully connect the database. Learn what requirements your " +"databases has " +msgstr "" +"Me whakaoti e ētahi pātengi raraunga kua tīpakohia ētahi atu āpure i te ripa" +" Aromatawai hei hono pai i te pātengi raraunga. Akona ngā hiahiatanga o ō " +"pātengi raraunga " + +msgid "Select dataset source" +msgstr "Tīpakohia puna rārangi raraunga" + +msgid "Select file" +msgstr "Tīpakohia kōnae" + +msgid "Select filter" +msgstr "Tīpakohia tātari" + +msgid "Select filter plugin using AntD" +msgstr "Tīpakohia mono tātari mā te AntD" + +msgid "Select first filter value by default" +msgstr "Tīpakohia te uara tātari tuatahi mā te taunoa" + +msgid "Select format" +msgstr "Tīpakohia hōputu" + +msgid "" +"Select one or many metrics to display, that will be displayed in the " +"percentages of total. Percentage metrics will be calculated only from data " +"within the row limit. You can use an aggregation function on a column or " +"write custom SQL to create a percentage metric." +msgstr "" +"Tīpakohia tētahi, nui ake rānei ine hei whakaatu, ka whakaaturia i ngā ōrau " +"o te katoa. Ka tatauhia ngā ine ōrau mai anake i ngā raraunga i roto i te " +"tepe rārangi. Ka taea e koe te whakamahi i tētahi taumahi whakaarotau i " +"runga i tētahi tīwae, te tuhi SQL ritenga rānei hei hanga i tētahi ine ōrau." + +msgid "" +"Select one or many metrics to display. You can use an aggregation function " +"on a column or write custom SQL to create a metric." +msgstr "" +"Tīpakohia tētahi, nui ake rānei ine hei whakaatu. Ka taea e koe te whakamahi" +" i tētahi taumahi whakaarotau i runga i tētahi tīwae, te tuhi SQL ritenga " +"rānei hei hanga i tētahi ine." + +msgid "Select operator" +msgstr "Tīpakohia kaiwhakahaere" + +msgid "Select or type a custom value..." +msgstr "Tīpakohia, pato rānei i tētahi uara ritenga..." + +msgid "Select or type a value" +msgstr "Tīpakohia, pato rānei i tētahi uara" + +msgid "Select or type currency symbol" +msgstr "Tīpakohia, pato rānei i te tohu moni" + +msgid "Select or type dataset name" +msgstr "Tīpakohia, pato rānei i te ingoa rārangi raraunga" + +msgid "Select owners" +msgstr "Tīpakohia rangatira" + +msgid "Select page size" +msgstr "Tīpakohia rahi whārangi" + +msgid "Select roles" +msgstr "Tīpakohia tūranga" + +msgid "Select saved metrics" +msgstr "Tīpakohia ine kua tiakina" + +msgid "Select saved queries" +msgstr "Tīpakohia pātai kua tiakina" + +msgid "Select schema or type to search schemas" +msgstr "Tīpakohia hanga, pato rānei hei rapu hanga" + +msgid "Select scheme" +msgstr "Tīpakohia kaupapa" + +msgid "" +"Select shape for computing values. \"FIXED\" sets all zoom levels to the " +"same size. \"LINEAR\" increases sizes linearly based on specified slope. " +"\"EXP\" increases sizes exponentially based on specified exponent" +msgstr "" +"Tīpakohia hanga hei tatau i ngā uara. \"FIXED\" ka tautuhi i ngā taumata " +"topa katoa ki te rahi ōrite. \"LINEAR\" ka piki i ngā rahi i runga i te taha" +" kua tohua. \"EXP\" ka piki i ngā rahi i runga i te pūmahi kua tohua" + +msgid "Select subject" +msgstr "Tīpakohia kaupapa" + +msgid "Select tab" +msgstr "Tīpakohia ripa" + +msgid "Select table or type to search tables" +msgstr "Tīpakohia ripanga, pato rānei hei rapu ripanga" + +msgid "Select the Annotation Layer you would like to use." +msgstr "Tīpakohia te Papa Tohu e hiahia ana koe ki te whakamahi." + +msgid "" +"Select the charts to which you want to apply cross-filters in this " +"dashboard. Deselecting a chart will exclude it from being filtered when " +"applying cross-filters from any chart on the dashboard. You can select \"All" +" charts\" to apply cross-filters to all charts that use the same dataset or " +"contain the same column name in the dashboard." +msgstr "" +"Tīpakohia ngā kauwhata e hiahia ana koe ki te whakahaeretia i ngā tātari-" +"whiti i tēnei papatohu. Mā te kore-tīpako i tētahi kauwhata ka whakakorehia " +"mai i te tātaritanga ina whakahaeretia ngā tātari-whiti mai i tētahi " +"kauwhata i te papatohu. Ka taea e koe te tīpako \"Kauwhata katoa\" hei " +"whakahaeretia i ngā tātari-whiti ki ngā kauwhata katoa e whakamahi ana i te " +"rārangi raraunga ōrite, kei roto rānei te ingoa tīwae ōrite i te papatohu." + +msgid "" +"Select the charts to which you want to apply cross-filters when interacting " +"with this chart. You can select \"All charts\" to apply filters to all " +"charts that use the same dataset or contain the same column name in the " +"dashboard." +msgstr "" +"Tīpakohia ngā kauwhata e hiahia ana koe ki te whakahaeretia i ngā tātari-" +"whiti ina taunekeneke ana me tēnei kauwhata. Ka taea e koe te tīpako " +"\"Kauwhata katoa\" hei whakahaeretia i ngā tātari ki ngā kauwhata katoa e " +"whakamahi ana i te rārangi raraunga ōrite, kei roto rānei te ingoa tīwae " +"ōrite i te papatohu." + +msgid "Select the geojson column" +msgstr "Tīpakohia te tīwae geojson" + +#, python-format +msgid "" +"Select values in highlighted field(s) in the control panel. Then run the " +"query by clicking on the %s button." +msgstr "" +"Tīpakohia ngā uara i ngā āpure kua whakamiramiramirahia i te papa " +"whakahaere. Kātahi ka whakahaere i te pātai mā te pāwhiri i te pātene %s." + +msgid "Selecting a database is required" +msgstr "E hiahiatia ana te tīpako i tētahi pātengi raraunga" + +msgid "Send as CSV" +msgstr "Tuku hei CSV" + +msgid "Send as PDF" +msgstr "Tuku hei PDF" + +msgid "Send as PNG" +msgstr "Tuku hei PNG" + +msgid "Send as text" +msgstr "Tuku hei kupu" + +msgid "September" +msgstr "Mahuru" + +msgid "Sequential" +msgstr "Raupapa" + +msgid "Series" +msgstr "Raupapa" + +msgid "Series Height" +msgstr "Teitei Raupapa" + +msgid "Series Order" +msgstr "Raupapa Raupapa" + +msgid "Series Style" +msgstr "Kāhua Raupapa" + +msgid "Series chart type (line, bar etc)" +msgstr "Momo kauwhata raupapa (rārangi, pae me ērā atu)" + +msgid "Series colors" +msgstr "Tae raupapa" + +msgid "Series limit" +msgstr "Tepe raupapa" + +msgid "Series type" +msgstr "Momo raupapa" + +msgid "Server Page Length" +msgstr "Roa Whārangi Tūmau" + +msgid "Server pagination" +msgstr "Whārangitanga tūmau" + +msgid "Service Account" +msgstr "Kaute Ratonga" + +msgid "Service version" +msgstr "Putanga ratonga" + +msgid "Set auto-refresh interval" +msgstr "Tautuhi wā whakahou-aunoa" + +msgid "Set filter mapping" +msgstr "Tautuhi whakaahuatanga tātari" + +msgid "Set header rows and the number of rows to read or skip." +msgstr "" +"Tautuhi rārangi pane me te maha o ngā rārangi hei pānui, hei poke rānei." + +msgid "Set up an email report" +msgstr "Whakatū pūrongo īmēra" + +msgid "Set up basic details, such as name and description." +msgstr "Whakatū taipitopito taketake, pērā i te ingoa me te whakamārama." + +msgid "" +"Sets the hierarchy levels of the chart. Each level is\n" +" represented by one ring with the innermost circle as the top of the hierarchy." +msgstr "Ka tautuhi i ngā taumata taumata o te kauwhata. Ko ia taumata e" + +msgid "Settings" +msgstr "Tautuhinga" + +msgid "Settings for time series" +msgstr "Tautuhinga mō te raupapa wā" + +msgid "Shape" +msgstr "Hanga" + +msgid "Share" +msgstr "Tuari" + +msgid "Share chart by email" +msgstr "Tuari kauwhata mā te īmēra" + +msgid "Share permalink by email" +msgstr "Tuari hononga-ā-mau mā te īmēra" + +msgid "Shared query" +msgstr "Pātai tuari" + +msgid "Shared query fields" +msgstr "Āpure pātai tuari" + +msgid "Sheet name" +msgstr "Ingoa hīti" + +msgid "Shift + Click to sort by multiple columns" +msgstr "Shift + Pāwhiri hei kōmaka mā ngā tīwae maha" + +msgid "Shift start date" +msgstr "Neke rā tīmata" + +msgid "Short description must be unique for this layer" +msgstr "Me ahurei te whakamārama poto mō tēnei papa" + +msgid "" +"Should daily seasonality be applied. An integer value will specify Fourier " +"order of seasonality." +msgstr "" +"Me whakahaeretia te wātanga wā ia rā. Ka tohua e tētahi uara tōpū te raupapa" +" Fourier o te wātanga wā." + +msgid "" +"Should weekly seasonality be applied. An integer value will specify Fourier " +"order of seasonality." +msgstr "" +"Me whakahaeretia te wātanga wā ia wiki. Ka tohua e tētahi uara tōpū te " +"raupapa Fourier o te wātanga wā." + +msgid "" +"Should yearly seasonality be applied. An integer value will specify Fourier " +"order of seasonality." +msgstr "" +"Me whakahaeretia te wātanga wā ia tau. Ka tohua e tētahi uara tōpū te " +"raupapa Fourier o te wātanga wā." + +msgid "Show" +msgstr "Whakaatu" + +#, python-format +msgid "Show %s entries" +msgstr "Whakaatu %s urunga" + +msgid "Show Bubbles" +msgstr "Whakaatu Pōro" + +msgid "Show CREATE VIEW statement" +msgstr "Whakaatu kīanga CREATE VIEW" + +msgid "Show cell bars" +msgstr "Whakaatu pae pūtau" + +msgid "Show Dashboard" +msgstr "Whakaatu Papatohu" + +msgid "Show Labels" +msgstr "Whakaatu Tapanga" + +msgid "Show Log" +msgstr "Whakaatu Rārangi" + +msgid "Show Markers" +msgstr "Whakaatu Tohu" + +msgid "Show Metric Names" +msgstr "Whakaatu Ingoa Ine" + +msgid "Show Range Filter" +msgstr "Whakaatu Tātari Korahi" + +msgid "Show Timestamp" +msgstr "Whakaatu Waitohu" + +msgid "Show Tooltip Labels" +msgstr "Whakaatu Tapanga Kītukutuku" + +msgid "Show Total" +msgstr "Whakaatu Tapeke" + +msgid "Show Trend Line" +msgstr "Whakaatu Rārangi Ia" + +msgid "Show Upper Labels" +msgstr "Whakaatu Tapanga Runga" + +msgid "Show Value" +msgstr "Whakaatu Uara" + +msgid "Show Values" +msgstr "Whakaatu Uara" + +msgid "Show Y-axis" +msgstr "Whakaatu Tukutuku-Y" + +msgid "" +"Show Y-axis on the sparkline. Will display the manually set min/max if set " +"or min/max values in the data otherwise." +msgstr "" +"Whakaatu te tukutuku-Y i te rārangi kōhā. Ka whakaatu i te iti/rahi kua " +"tautuhia ā-ringa mēnā kua tautuhia, i ngā uara iti/rahi i ngā raraunga " +"rānei." + +msgid "Show all columns" +msgstr "Whakaatu tīwae katoa" + +msgid "Show axis line ticks" +msgstr "Whakaatu tika rārangi tukutuku" + +msgid "Show chart description" +msgstr "Whakaatu whakamārama kauwhata" + +msgid "Show columns subtotal" +msgstr "Whakaatu tapeke tīwae" + +msgid "Show columns total" +msgstr "Whakaatu tapeke tīwae katoa" + +msgid "Show data points as circle markers on the lines" +msgstr "Whakaatu tohu raraunga hei tohu porohita i ngā rārangi" + +msgid "Show empty columns" +msgstr "Whakaatu tīwae kau" + +msgid "Show entries per page" +msgstr "Whakaatu urunga ia whārangi" + +msgid "" +"Show hierarchical relationships of data, with the value represented by area," +" showing proportion and contribution to the whole." +msgstr "" +"Whakaatu hononga taumata o ngā raraunga, ko te uara e tohua ana e te " +"horahanga, e whakaatu ana i te ōwehenga me te whakauru ki te katoa." + +msgid "Show info tooltip" +msgstr "Whakaatu kītukutuku mōhiohio" + +msgid "Show label" +msgstr "Whakaatu tapanga" + +msgid "Show labels when the node has children." +msgstr "Whakaatu tapanga ina whai tamariki te pona." + +msgid "Show legend" +msgstr "Whakaatu kōrero" + +msgid "Show less columns" +msgstr "Whakaatu iti ake ngā tīwae" + +msgid "Show minor ticks on axes." +msgstr "Whakaatu tika iti i ngā tukutuku." + +msgid "Show only my charts" +msgstr "Whakaatu ōku kauwhata anake" + +msgid "Show password." +msgstr "Whakaatu kupuhipa." + +msgid "Show percentage" +msgstr "Whakaatu ōrau" + +msgid "Show pointer" +msgstr "Whakaatu tohu" + +msgid "Show progress" +msgstr "Whakaatu kokenga" + +msgid "Show rows subtotal" +msgstr "Whakaatu tapeke rārangi" + +msgid "Show rows total" +msgstr "Whakaatu tapeke rārangi katoa" + +msgid "Show series values on the chart" +msgstr "Whakaatu uara raupapa i te kauwhata" + +msgid "Show split lines" +msgstr "Whakaatu rārangi wehe" + +msgid "Show summary" +msgstr "Whakaatu whakarāpopototanga" + +msgid "Show the value on top of the bar" +msgstr "Whakaatu te uara i runga i te pae" + +msgid "Show total" +msgstr "Whakaatu tapeke" + +msgid "" +"Show total aggregations of selected metrics. Note that row limit does not " +"apply to the result." +msgstr "" +"Whakaatu whakaarotau tapeke o ngā ine kua tīpakohia. Kia mōhio karekau te " +"tepe rārangi e pā ana ki te hua." + +msgid "" +"Showcases a single metric front-and-center. Big number is best used to call " +"attention to a KPI or the one thing you want your audience to focus on." +msgstr "" +"Ka whakaatu i tētahi ine kotahi i te tāhuna-me-te-pokapū. Ka pai rawa atu te" +" Tau Nui hei karanga i te aro ki tētahi KPI, ki te mea kotahi rānei e hiahia" +" ana koe kia aro tō hunga mātakitaki." + +msgid "" +"Showcases a single number accompanied by a simple line chart, to call " +"attention to an important metric along with its change over time or other " +"dimension." +msgstr "" +"Ka whakaatu i tētahi tau kotahi me tētahi kauwhata rārangi māmā, hei karanga" +" i te aro ki tētahi ine nui tahi me tōna panoni i te wā, i tētahi āhuahanga " +"atu rānei." + +msgid "" +"Showcases how a metric changes as the funnel progresses. This classic chart " +"is useful for visualizing drop-off between stages in a pipeline or " +"lifecycle." +msgstr "" +"Ka whakaatu i te panoni o tētahi ine i te haerenga o te kōrere. He whaihua " +"tēnei kauwhata tawhito hei whakakite i te taka i waenga i ngā wāhanga i " +"tētahi paipa, i tētahi rerenga koiora rānei." + +msgid "" +"Showcases the flow or link between categories using thickness of chords. The" +" value and corresponding thickness can be different for each side." +msgstr "" +"Ka whakaatu i te rere, i te hono rānei i waenga i ngā kāwai mā te mātotoru o" +" ngā kōrua. Ka taea e te uara me te mātotoru hāngai te rerekē mō ia taha." + +msgid "" +"Showcases the progress of a single metric against a given target. The higher" +" the fill, the closer the metric is to the target." +msgstr "" +"Ka whakaatu i te kokenga o tētahi ine kotahi ki tētahi whāinga kua tukuna. " +"Ko te teitei o te whakakī, ko te tata o te ine ki te whāinga." + +#, python-format +msgid "Showing %s of %s items" +msgstr "E whakaatu ana %s o %s mea" + +msgid "Shows a list of all series available at that point in time" +msgstr "" +"Ka whakaatu i tētahi rārangi o ngā raupapa katoa e wātea ana i taua wā" + +msgid "Shows or hides markers for the time series" +msgstr "Ka whakaatu, ka huna rānei i ngā tohu mō te raupapa wā" + +msgid "Significance Level" +msgstr "Taumata Hiranga" + +msgid "Simple" +msgstr "Māmā" + +msgid "Simple ad-hoc metrics are not enabled for this dataset" +msgstr "Karekau e whakahohengia ngā ine ad-hoc māmā mō tēnei rārangi raraunga" + +msgid "Single" +msgstr "Takitahi" + +msgid "Single Metric" +msgstr "Ine Takitahi" + +msgid "Single Value" +msgstr "Uara Takitahi" + +msgid "Single value" +msgstr "Uara takitahi" + +msgid "Single value type" +msgstr "Momo uara takitahi" + +msgid "Size in pixels" +msgstr "Rahi i ngā pika" + +msgid "Size of edge symbols" +msgstr "Rahi o ngā tohu tapa" + +msgid "Size of marker. Also applies to forecast observations." +msgstr "Rahi o te tohu. Ka pā hoki ki ngā tirohanga matapae." + +msgid "Skip blank lines rather than interpreting them as Not A Number values" +msgstr "Poke i ngā rārangi kau, kaua e whakamāori hei uara Ehara i te Tau" + +msgid "Skip rows" +msgstr "Poke rārangi" + +msgid "Skip spaces after delimiter" +msgstr "Poke mokowā i muri i te tohutuhi" + +msgid "Slug" +msgstr "Slug" + +msgid "Small" +msgstr "Iti" + +msgid "Small number format" +msgstr "Hōputu tau iti" + +msgid "Smooth Line" +msgstr "Rārangi Māeneene" + +msgid "" +"Smooth-line is a variation of the line chart. Without angles and hard edges," +" Smooth-line sometimes looks smarter and more professional." +msgstr "" +"He rerekētanga o te kauwhata rārangi te rārangi-māeneene. Me te kore koki me" +" ngā tapa mārō, ka āhua mōhio ake, ka tairanga ake pea te Rārangi-māeneene." + +msgid "Solid" +msgstr "Mārō" + +msgid "Some roles do not exist" +msgstr "Karekau ētahi tūranga" + +msgid "" +"Something went wrong with embedded authentication. Check the dev console for" +" details." +msgstr "" +"I hē tētahi mea ki te motuhēhēnga whakamana. Tirohia te kauwhata " +"whanaketanga mō ngā taipitopito." + +msgid "Something went wrong." +msgstr "I hē tētahi mea." + +#, python-format +msgid "Sorry there was an error fetching database information: %s" +msgstr "" +"Aroha mai, i puta he hapa i te tikitanga o ngā mōhiohio pātengi raraunga: %s" + +msgid "Sorry there was an error fetching saved charts: " +msgstr "Aroha mai, i puta he hapa i te tikitanga o ngā kauwhata kua tiakina: " + +msgid "Sorry, An error occurred" +msgstr "Aroha mai, I puta he hapa" + +msgid "Sorry, an error occurred" +msgstr "Aroha mai, i puta he hapa" + +msgid "Sorry, an unknown error occurred" +msgstr "Aroha mai, i puta he hapa kāore e mōhiotia ana" + +msgid "Sorry, an unknown error occurred." +msgstr "Aroha mai, i puta he hapa kāore e mōhiotia ana." + +msgid "Sorry, something went wrong. Embedding could not be deactivated." +msgstr "Aroha mai, i hē tētahi mea. Kāore i taea te whakakore i te tāmau." + +msgid "Sorry, something went wrong. Please try again." +msgstr "Aroha mai, i hē tētahi mea. Tēnā whakamātauhia anō." + +msgid "Sorry, something went wrong. Try again later." +msgstr "Aroha mai, i hē tētahi mea. Whakamātauhia anō ā muri ake nei." + +#, python-format +msgid "Sorry, there was an error saving this %s: %s" +msgstr "Aroha mai, i puta he hapa i te tiakitanga o tēnei %s: %s" + +#, python-format +msgid "Sorry, there was an error saving this dashboard: %s" +msgstr "Aroha mai, i puta he hapa i te tiakitanga o tēnei papatohu: %s" + +msgid "Sorry, your browser does not support copying." +msgstr "Aroha mai, karekau tō pūtirotiro e tautoko i te tārua." + +msgid "Sorry, your browser does not support copying. Use Ctrl / Cmd + C!" +msgstr "" +"Aroha mai, karekau tō pūtirotiro e tautoko i te tārua. Whakamahia Ctrl / Cmd" +" + C!" + +msgid "Sort" +msgstr "Kōmaka" + +msgid "Sort Descending" +msgstr "Kōmaka Heke" + +msgid "Sort Metric" +msgstr "Kōmaka Ine" + +msgid "Sort Series Ascending" +msgstr "Kōmaka Raupapa Piki" + +msgid "Sort Series By" +msgstr "Kōmaka Raupapa Mā" + +msgid "Sort X Axis" +msgstr "Kōmaka Tukutuku X" + +msgid "Sort Y Axis" +msgstr "Kōmaka Tukutuku Y" + +msgid "Sort ascending" +msgstr "Kōmaka piki" + +msgid "Sort by" +msgstr "Kōmaka mā" + +#, python-format +msgid "Sort by %s" +msgstr "Kōmaka mā %s" + +msgid "Sort by metric" +msgstr "Kōmaka mā te ine" + +msgid "Sort columns alphabetically" +msgstr "Kōmaka tīwae mā te arapū" + +msgid "Sort columns by" +msgstr "Kōmaka tīwae mā" + +msgid "Sort descending" +msgstr "Kōmaka heke" + +msgid "Sort filter values" +msgstr "Kōmaka uara tātari" + +msgid "Sort metric" +msgstr "Kōmaka ine" + +msgid "Sort query by" +msgstr "Kōmaka pātai mā" + +msgid "Sort rows by" +msgstr "Kōmaka rārangi mā" + +msgid "Sort series in ascending order" +msgstr "Kōmaka raupapa i te raupapa piki" + +msgid "Sort type" +msgstr "Momo kōmaka" + +msgid "Source" +msgstr "Puna" + +msgid "Source SQL" +msgstr "SQL Puna" + +msgid "Source category" +msgstr "Kāwai puna" + +msgid "Sparkline" +msgstr "Rārangi Kōhā" + +msgid "Spatial" +msgstr "Tauwāhi" + +msgid "Specific Date/Time" +msgstr "Rā/Wā Motuhake" + +msgid "Specify name to CREATE TABLE AS schema in: public" +msgstr "Tohua ingoa hei CREATE TABLE AS hanga i: public" + +msgid "Specify name to CREATE VIEW AS schema in: public" +msgstr "Tohua ingoa hei CREATE VIEW AS hanga i: public" + +msgid "" +"Specify the database version. This is used with Presto for query cost " +"estimation, and Dremio for syntax changes, among others." +msgstr "" +"Tohua te putanga pātengi raraunga. Ka whakamahia tēnei ki te Presto mō te " +"tauwhitinga utu pātai, ki te Dremio mō ngā huringa wetereo, me ētahi atu." + +msgid "Split number" +msgstr "Tau wehe" + +msgid "Square kilometers" +msgstr "Kiromita tapawhā" + +msgid "Square meters" +msgstr "Mita tapawhā" + +msgid "Square miles" +msgstr "Maero tapawhā" + +msgid "Stack" +msgstr "Paparanga" + +msgid "Stack series" +msgstr "Raupapa paparanga" + +msgid "Stack series on top of each other" +msgstr "Paparanga raupapa runga ake i tētahi" + +msgid "Stacked" +msgstr "Paparanga" + +msgid "Stacked Bars" +msgstr "Pae Paparanga" + +msgid "Stacked Style" +msgstr "Kāhua Paparanga" + +msgid "Standard time series" +msgstr "Raupapa wā paerewa" + +msgid "Start" +msgstr "Tīmata" + +msgid "Start (Longitude, Latitude): " +msgstr "Tīmata (Longitude, Latitude): " + +msgid "Start Longitude & Latitude" +msgstr "Longitude me Latitude Tīmata" + +msgid "Start angle" +msgstr "Koki tīmata" + +msgid "Start at (UTC)" +msgstr "Tīmata i (UTC)" + +msgid "Start date" +msgstr "Rā tīmata" + +msgid "Start date included in time range" +msgstr "Rā tīmata kua whakauru ki te awhe wā" + +msgid "Start y-axis at 0" +msgstr "Tīmata tukutuku-y i te 0" + +msgid "" +"Start y-axis at zero. Uncheck to start y-axis at minimum value in the data." +msgstr "" +"Tīmata tukutuku-y i te kore. Kaua e pāti hei tīmata i te tukutuku-y i te " +"uara iti rawa i ngā raraunga." + +msgid "Started" +msgstr "Kua Tīmata" + +msgid "State" +msgstr "Tūnga" + +#, python-format +msgid "Statement %(statement_num)s out of %(statement_count)s" +msgstr "Kīanga %(statement_num)s i waho o %(statement_count)s" + +msgid "Statistical" +msgstr "Tauanga" + +msgid "Status" +msgstr "Tūnga" + +msgid "Step - end" +msgstr "Takahanga - mutunga" + +msgid "Step - middle" +msgstr "Takahanga - waenganui" + +msgid "Step - start" +msgstr "Takahanga - tīmata" + +msgid "Step type" +msgstr "Momo takahanga" + +msgid "Stepped Line" +msgstr "Rārangi Takahanga" + +msgid "" +"Stepped-line graph (also called step chart) is a variation of line chart but" +" with the line forming a series of steps between data points. A step chart " +"can be useful when you want to show the changes that occur at irregular " +"intervals." +msgstr "" +"He rerekētanga o te kauwhata rārangi te kauwhata rārangi-takahanga (e kīa " +"ana he kauwhata takahanga) engari ka hanga te rārangi i tētahi raupapa " +"takahanga i waenga i ngā tohu raraunga. Ka taea te whaihua o tētahi kauwhata" +" takahanga ina hiahia koe ki te whakaatu i ngā huringa e puta ana i ngā wā " +"kāore e rite ana." + +msgid "Stop" +msgstr "Mutu" + +msgid "Stop query" +msgstr "Mutu pātai" + +msgid "Stop running (Ctrl + e)" +msgstr "Mutu rere (Ctrl + e)" + +msgid "Stop running (Ctrl + x)" +msgstr "Mutu rere (Ctrl + x)" + +msgid "Stopped an unsafe database connection" +msgstr "I whakamutua tētahi hononga pātengi raraunga kore haumaru" + +msgid "Stream" +msgstr "Rere" + +msgid "Streets" +msgstr "Tiriti" + +msgid "Strength to pull the graph toward center" +msgstr "Kaha hei tō i te kauwhata ki te pokapū" + +msgid "Stroke Color" +msgstr "Tae Whakapā" + +msgid "Stroke Width" +msgstr "Whānui Whakapā" + +msgid "Stroked" +msgstr "Kua Whakapāhia" + +msgid "Structural" +msgstr "Hangahanga" + +msgid "Style" +msgstr "Kāhua" + +msgid "Style the ends of the progress bar with a round cap" +msgstr "Kāhua i ngā pito o te pae kokenga me te potae porohita" + +msgid "Subdomain" +msgstr "Rohe-iti" + +msgid "Subheader Font Size" +msgstr "Rahi Momotuhi Pane-iti" + +msgid "Submit" +msgstr "Tuku" + +msgid "Subtitle" +msgstr "Taitara-iti" + +msgid "Subtitle Font Size" +msgstr "Rahi Momotuhi Taitara-iti" + +msgid "Subtotal" +msgstr "Tapeke-iti" + +msgid "Success" +msgstr "Angitu" + +msgid "Successfully changed dataset!" +msgstr "I angitu te huri i te rārangi raraunga!" + +msgid "Suffix" +msgstr "Kūmuri" + +msgid "Suffix to apply after the percentage display" +msgstr "Kūmuri hei whakahaeretia i muri i te whakaatu ōrau" + +msgid "Sum" +msgstr "Tapeke" + +msgid "Sum as Fraction of Columns" +msgstr "Tapeke hei Hautanga o ngā Tīwae" + +msgid "Sum as Fraction of Rows" +msgstr "Tapeke hei Hautanga o ngā Rārangi" + +msgid "Sum as Fraction of Total" +msgstr "Tapeke hei Hautanga o te Tapeke" + +msgid "Sum of values over specified period" +msgstr "Tapeke o ngā uara i te wā kua tohua" + +msgid "Sum values" +msgstr "Uara tapeke" + +msgid "Summary" +msgstr "Whakarāpopototanga" + +msgid "Sunburst Chart" +msgstr "Kauwhata Sunburst" + +msgid "Sunday" +msgstr "Rātapu" + +msgid "Superset Chart" +msgstr "Kauwhata Superset" + +msgid "Superset Embedded SDK documentation." +msgstr "Tuhinga SDK Tāmau Superset." + +msgid "Superset chart" +msgstr "Kauwhata Superset" + +msgid "Superset encountered an error while running a command." +msgstr "I tūtaki a Superset i tētahi hapa i te whakahaere i tētahi whakahau." + +msgid "Superset encountered an unexpected error." +msgstr "I tūtaki a Superset i tētahi hapa ohorere." + +msgid "Supported databases" +msgstr "Pātengi raraunga e tautokona ana" + +msgid "Swap dataset" +msgstr "Huri rārangi raraunga" + +msgid "Swap rows and columns" +msgstr "Huri rārangi me ngā tīwae" + +msgid "" +"Swiss army knife for visualizing data. Choose between step, line, scatter, " +"and bar charts. This viz type has many customization options as well." +msgstr "" +"Maripi tūmau Switi mō te whakakite i ngā raraunga. Kōwhiria i waenga i ngā " +"kauwhata takahanga, rārangi, marara me te pae. He maha ngā kōwhiringa " +"whakaritenga o tēnei momo viz." + +msgid "Switch to the next tab" +msgstr "Huri ki te ripa panuku" + +msgid "Switch to the previous tab" +msgstr "Huri ki te ripa tōmua" + +msgid "Symbol" +msgstr "Tohu" + +msgid "Symbol of two ends of edge line" +msgstr "Tohu o ngā pito e rua o te rārangi tapa" + +msgid "Symbol size" +msgstr "Rahi tohu" + +msgid "Sync Permissions" +msgstr "Hāngai Mōtika" + +msgid "Sync columns from source" +msgstr "Hāngai tīwae mai i te puna" + +#, python-format +msgid "Syncing permissions for %s" +msgstr "E hāngai ana i ngā mōtika mō %s" + +#, python-format +msgid "Syncing permissions for %s in the background" +msgstr "E hāngai ana i ngā mōtika mō %s i te papamuri" + +msgid "Syntax" +msgstr "Wetereo" + +#, python-format +msgid "Syntax Error: %(qualifier)s input \"%(input)s\" expecting \"%(expected)s" +msgstr "" +"Hapa Wetereo: %(qualifier)s tāuru \"%(input)s\" e tūmanako ana " +"\"%(expected)s" + +msgid "TABLES" +msgstr "RIPANGA" + +msgid "TEMPORAL_RANGE" +msgstr "TEMPORAL_RANGE" + +msgid "THU" +msgstr "PAR" + +msgid "TUE" +msgstr "TŪR" + +msgid "Tab name" +msgstr "Ingoa ripa" + +#, python-format +msgid "Tab schema is invalid, caused by: %(error)s" +msgstr "He muhu te hanga ripa, nā: %(error)s" + +msgid "Tab title" +msgstr "Taitara ripa" + +msgid "Table" +msgstr "Ripanga" + +#, python-format +msgid "Table %(table)s wasn't found in the database %(db)s" +msgstr "Kāore i kitea te ripanga %(table)s i te pātengi raraunga %(db)s" + +msgid "Table Name" +msgstr "Ingoa Ripanga" + +#, python-format +msgid "" +"Table [%(table)s] could not be found, please double check your database " +"connection, schema, and table name" +msgstr "" +"Kāore i kitea te Ripanga [%(table)s], tēnā tirohia anō tō hononga pātengi " +"raraunga, tō hanga, me tō ingoa ripanga" + +msgid "Table actions" +msgstr "Mahinga ripanga" + +msgid "" +"Table already exists. You can change your 'if table already exists' strategy" +" to append or replace or provide a different Table Name to use." +msgstr "" +"Kei te tīari kē te ripanga. Ka taea e koe te huri i tō rautaki 'mēnā kei te " +"tīari kē te ripanga' ki te tāpiri, ki te whakakapi rānei, ki te whakarato " +"rānei i tētahi Ingoa Ripanga rerekē hei whakamahi." + +msgid "Table cache timeout" +msgstr "Wā kore-mahi keteroki ripanga" + +msgid "Table columns" +msgstr "Tīwae ripanga" + +msgid "Table name" +msgstr "Ingoa ripanga" + +msgid "Table name undefined" +msgstr "Kāore i tautuhia te ingoa ripanga" + +#, python-format +msgid "Table or View \"%(table)s\" does not exist." +msgstr "Karekau te Ripanga, te Tirohanga \"%(table)s\" rānei." + +msgid "" +"Table that visualizes paired t-tests, which are used to understand " +"statistical differences between groups." +msgstr "" +"Ripanga ka whakakite i ngā whakamātau-t takirua, ka whakamahia hei mārama i " +"ngā rerekētanga tauanga i waenga i ngā rōpū." + +msgid "Tables" +msgstr "Ripanga" + +msgid "Tabs" +msgstr "Ripa" + +msgid "Tabular" +msgstr "Ripanga" + +msgid "Tag" +msgstr "Tohu" + +msgid "Tag could not be created." +msgstr "Kāore i taea te hanga i te tohu." + +msgid "Tag could not be deleted." +msgstr "Kāore i taea te muku i te tohu." + +msgid "Tag could not be found." +msgstr "Kāore i kitea te tohu." + +msgid "Tag could not be updated." +msgstr "Kāore i taea te whakahou i te tohu." + +msgid "Tag created" +msgstr "Tohu kua hangaia" + +msgid "Tag name" +msgstr "Ingoa tohu" + +msgid "Tag name is invalid (cannot contain ':')" +msgstr "He muhu te ingoa tohu (kāore e taea te whai ':')" + +msgid "Tag parameters are invalid." +msgstr "He muhu ngā tawhā tohu." + +msgid "Tag updated" +msgstr "Tohu kua whakahouhia" + +#, python-format +msgid "Tagged %s %ss" +msgstr "Kua tohuhia %s %ss" + +msgid "Tagged Object could not be deleted." +msgstr "Kāore i taea te muku i te Ahanoa Kua Tohuhia." + +msgid "Tags" +msgstr "Tohu" + +msgid "Target" +msgstr "Whāinga" + +msgid "Target Color" +msgstr "Tae Whāinga" + +msgid "Target category" +msgstr "Kāwai whāinga" + +msgid "Target value" +msgstr "Uara whāinga" + +msgid "Template" +msgstr "Tauira" + +msgid "Template parameters" +msgstr "Tawhā tauira" + +msgid "" +"Templated link, it's possible to include {{ metric }} or other values coming" +" from the controls." +msgstr "" +"Hono tauira, ka taea te whakauru i {{ metric }}, i ētahi atu uara rānei mai " +"i ngā whakahaere." + +msgid "Temporal X-Axis" +msgstr "Tukutuku-X Wā" + +msgid "" +"Terminate running queries when browser window closed or navigated to another" +" page. Available for Presto, Hive, MySQL, Postgres and Snowflake databases." +msgstr "" +"Whakamutua i ngā pātai e rere ana ina katia te matapihi pūtirotiro, ina " +"whakatere rānei ki tētahi whārangi kē. Kei te wātea mō ngā pātengi raraunga " +"Presto, Hive, MySQL, Postgres me Snowflake." + +msgid "Test Connection" +msgstr "Whakamātau Hononga" + +msgid "Test connection" +msgstr "Whakamātau hononga" + +msgid "Text" +msgstr "Kupu" + +msgid "Text / Markdown" +msgstr "Kupu / Markdown" + +msgid "Text align" +msgstr "Whakarite kupu" + +msgid "Text embedded in email" +msgstr "Kupu tāmautia i te īmēra" + +#, python-format +msgid "The API response from %s does not match the IDatabaseTable interface." +msgstr "" +"Karekau te whakautu API mai i %s e hāngai ana ki te papatohu IDatabaseTable." + +msgid "" +"The CSS for individual dashboards can be altered here, or in the dashboard " +"view where changes are immediately visible" +msgstr "" +"Ka taea te huri i te CSS mō ngā papatohu takitahi ki konei, ki te tirohanga " +"papatohu rānei kei reira ka kitea ohorere ngā huringa" + +msgid "" +"The CTAS (create table as select) doesn't have a SELECT statement at the " +"end. Please make sure your query has a SELECT as its last statement. Then, " +"try running your query again." +msgstr "" +"Karekau tō te CTAS (hanga ripanga hei tīpako) he kīanga SELECT i te mutunga." +" Tēnā kia mārama he SELECT tō kīanga whakamutunga o tō pātai. Kātahi, " +"whakamātauhia anō tō pātai." + +msgid "" +"The GeoJsonLayer takes in GeoJSON formatted data and renders it as " +"interactive polygons, lines and points (circles, icons and/or texts)." +msgstr "" +"Ka tango te GeoJsonLayer i ngā raraunga hōputu GeoJSON, ā, ka whakaatu hei " +"tapawhā taunekeneke, hei rārangi me ngā tohu (porohita, tohu me/rānei kupu)." + +msgid "" +"The Sankey chart visually tracks the movement and transformation of values across\n" +" system stages. Nodes represent stages, connected by links depicting value flow. Node\n" +" height corresponds to the visualized metric, providing a clear representation of\n" +" value distribution and transformation." +msgstr "" +"Ka whai te kauwhata Sankey i te nekeneke me te whakaahua o ngā uara puta noa" + +msgid "The URL is missing the dataset_id or slice_id parameters." +msgstr "Kei te ngaro i te URL ngā tawhā dataset_id, slice_id rānei." + +msgid "The X-axis is not on the filters list" +msgstr "Kāore te tukutuku-X i runga i te rārangi tātari" + +msgid "" +"The X-axis is not on the filters list which will prevent it from being used in\n" +" time range filters in dashboards. Would you like to add it to the filters list?" +msgstr "" +"Kāore te tukutuku-X i runga i te rārangi tātari, ā, ka aukati tēnei i te " +"whakamahitanga i ngā" + +msgid "The annotation has been saved" +msgstr "Kua tiakina te tohu" + +msgid "The annotation has been updated" +msgstr "Kua whakahouhia te tohu" + +msgid "The background color of the charts." +msgstr "Te tae papamuri o ngā kauwhata." + +msgid "" +"The category of source nodes used to assign colors. If a node is associated " +"with more than one category, only the first will be used." +msgstr "" +"Te kāwai o ngā pona puna ka whakamahia hei tūtohu i ngā tae. Mēnā e hāngai " +"ana tētahi pona ki te nui atu i te kotahi kāwai, ko te tuatahi anake ka " +"whakamahia." + +msgid "The chart datasource does not exist" +msgstr "Karekau te puna raraunga kauwhata" + +msgid "The chart does not exist" +msgstr "Karekau te kauwhata" + +msgid "The chart query context does not exist" +msgstr "Karekau te horopaki pātai kauwhata" + +msgid "" +"The classic. Great for showing how much of a company each investor gets, what demographics follow your blog, or what portion of the budget goes to the military industrial complex.\n" +"\n" +" Pie charts can be difficult to interpret precisely. If clarity of relative proportion is important, consider using a bar or other chart type instead." +msgstr "" +"Te tawhito. He pai rawa mō te whakaatu i te nui o tētahi kamupene ka whiwhi " +"ia kaituku pūtea, ko ēhea ngā āhuahanga tūpāpori e whai ana i tō rangitaki, " +"ko tēhea wāhanga rānei o te pūtea ka haere ki te rāngai pakihi whawhai." + +msgid "The color for points and clusters in RGB" +msgstr "Te tae mō ngā tohu me ngā rāpaki i te RGB" + +msgid "The color of the elements border" +msgstr "Te tae o te tapa o ngā huānga" + +msgid "The color of the isoband" +msgstr "Te tae o te isoband" + +msgid "The color of the isoline" +msgstr "Te tae o te isoline" + +msgid "The color scheme for rendering chart" +msgstr "Te kaupapa tae mō te whakaatu i te kauwhata" + +msgid "" +"The color scheme is determined by the related dashboard.\n" +" Edit the color scheme in the dashboard properties." +msgstr "Ka whakatau te kaupapa tae e te papatohu hāngai." + +msgid "" +"The colors of this chart might be overridden by custom label colors of the related dashboard.\n" +" Check the JSON metadata in the Advanced settings." +msgstr "" +"Ka taea pea e ngā tae tapanga ritenga o te papatohu hāngai te whakakapi i " +"ngā tae o tēnei kauwhata." + +msgid "The column header label" +msgstr "Te tapanga pane tīwae" + +msgid "The column to be used as the source of the edge." +msgstr "Te tīwae ka whakamahia hei puna o te tapa." + +msgid "The column to be used as the target of the edge." +msgstr "Te tīwae ka whakamahia hei whāinga o te tapa." + +msgid "The column was deleted or renamed in the database." +msgstr "I mukua, i whakaingoahia-anō rānei te tīwae i te pātengi raraunga." + +msgid "The configuration for the map layers" +msgstr "Te whirihora mō ngā papa mahere" + +msgid "The corner radius of the chart background" +msgstr "Te pūtoro koki o te papamuri kauwhata" + +msgid "" +"The country code standard that Superset should expect to find in the " +"[country] column" +msgstr "" +"Te paerewa waehere whenua e tūmanakohia ana e Superset kia kitea i te tīwae " +"[whenua]" + +msgid "The dashboard has been saved" +msgstr "Kua tiakina te papatohu" + +msgid "The data source seems to have been deleted" +msgstr "Kua mukua pea te puna raraunga" + +msgid "The database" +msgstr "Te pātengi raraunga" + +msgid "The database columns that contains lines information" +msgstr "Ngā tīwae pātengi raraunga kei roto ngā mōhiohio rārangi" + +msgid "The database could not be found" +msgstr "Kāore i kitea te pātengi raraunga" + +msgid "The database is currently running too many queries." +msgstr "" +"Kei te rere te tini rawa o ngā pātai i te pātengi raraunga i tēnei wā." + +msgid "The database is under an unusual load." +msgstr "Kei raro i tētahi uta rerekē te pātengi raraunga." + +msgid "" +"The database referenced in this query was not found. Please contact an " +"administrator for further assistance or try again." +msgstr "" +"Kāore i kitea te pātengi raraunga kua tohutorohia i tēnei pātai. Tēnā " +"whakapā atu ki tētahi kaiwhakahaere mō te āwhina, whakamātauhia anō rānei." + +msgid "The database returned an unexpected error." +msgstr "I whakahoki mai te pātengi raraunga i tētahi hapa ohorere." + +msgid "The database that was used to generate this query could not be found" +msgstr "" +"Kāore i kitea te pātengi raraunga i whakamahia hei hanga i tēnei pātai" + +msgid "The database was deleted." +msgstr "I mukua te pātengi raraunga." + +msgid "The database was not found." +msgstr "Kāore i kitea te pātengi raraunga." + +msgid "The dataset" +msgstr "Te rārangi raraunga" + +msgid "The dataset associated with this chart no longer exists" +msgstr "Kāore e tīari ana te rārangi raraunga e hāngai ana ki tēnei kauwhata" + +msgid "" +"The dataset column/metric that returns the values on your chart's x-axis." +msgstr "" +"Te tīwae/ine rārangi raraunga ka whakahoki i ngā uara i te tukutuku-x o tō " +"kauwhata." + +msgid "" +"The dataset column/metric that returns the values on your chart's y-axis." +msgstr "" +"Te tīwae/ine rārangi raraunga ka whakahoki i ngā uara i te tukutuku-y o tō " +"kauwhata." + +msgid "" +"The dataset configuration exposed here\n" +" affects all the charts using this dataset.\n" +" Be mindful that changing settings\n" +" here may affect other charts\n" +" in undesirable ways." +msgstr "Ka pā te whirihora rārangi raraunga kua whakaaturia ki konei" + +msgid "The dataset has been saved" +msgstr "Kua tiakina te rārangi raraunga" + +msgid "The dataset linked to this chart may have been deleted." +msgstr "Kua mukua pea te rārangi raraunga e hono ana ki tēnei kauwhata." + +msgid "The datasource couldn't be loaded" +msgstr "Kāore i taea te uta i te puna raraunga" + +msgid "The datasource is too large to query." +msgstr "He rahi rawa te puna raraunga hei pātai." + +msgid "The default catalog that should be used for the connection." +msgstr "Te kātaloka taunoa me whakamahi mō te hononga." + +msgid "The default schema that should be used for the connection." +msgstr "Te hanga taunoa me whakamahi mō te hononga." + +msgid "" +"The description can be displayed as widget headers in the dashboard view. " +"Supports markdown." +msgstr "" +"Ka taea te whakaatu i te whakamārama hei pane waeine i te tirohanga " +"papatohu. Ka tautoko i te markdown." + +msgid "The distance between cells, in pixels" +msgstr "Te tawhiti i waenga i ngā pūtau, i ngā pika" + +msgid "" +"The duration of time in seconds before the cache is invalidated. Set to -1 " +"to bypass the cache." +msgstr "" +"Te roa o te wā i ngā hēkona i mua i te whakamuhutanga o te keteroki. " +"Tautuhia ki -1 hei poke i te keteroki." + +msgid "The encoding format of the lines" +msgstr "Te hōputu whakakohu o ngā rārangi" + +msgid "" +"The engine_params object gets unpacked into the sqlalchemy.create_engine " +"call." +msgstr "" +"Ka wewetea te ahanoa engine_params ki te waea sqlalchemy.create_engine." + +msgid "The exponent to compute all sizes from. \"EXP\" only" +msgstr "Te pūmahi hei tatau i ngā rahi katoa mai. \"EXP\" anake" + +msgid "" +"The extent of the map on application start. FIT DATA automatically sets the " +"extent so that all data points are included in the viewport. CUSTOM allows " +"users to define the extent manually." +msgstr "" +"Te whānuitanga o te mahere i te tīmatanga o te taupānga. FIT DATA ka tautuhi" +" aunoa i te whānuitanga kia whai ngā tohu raraunga katoa i te tirohanga. " +"CUSTOM ka tukua ngā kaiwhakamahi ki te tautuhi i te whānuitanga ā-ringa." + +#, python-format +msgid "" +"The following entries in `series_columns` are missing in `columns`: " +"%(columns)s. " +msgstr "" +"Kei te ngaro ngā urunga e whai ake nei i `series_columns` i `columns`: " +"%(columns)s. " + +#, python-format +msgid "" +"The following filters have the 'Select first filter value by default'\n" +" option checked and could not be loaded, which is preventing the dashboard\n" +" from rendering: %s" +msgstr "" +"Kei te pātia ngā tātari e whai ake nei i te kōwhiringa 'Tīpakohia te uara " +"tātari tuatahi mā te taunoa'" + +msgid "The function to use when aggregating points into groups" +msgstr "Te taumahi hei whakamahi ina whakaarotau i ngā tohu ki ngā rōpū" + +msgid "The height of the current zoom level to compute all heights from" +msgstr "Te teitei o te taumata topa o nāianei hei tatau i ngā teitei katoa" + +msgid "" +"The histogram chart displays the distribution of a dataset by\n" +" representing the frequency or count of values within different ranges or bins.\n" +" It helps visualize patterns, clusters, and outliers in the data and provides\n" +" insights into its shape, central tendency, and spread." +msgstr "" +"Ka whakaatu te kauwhata auau i te tohatoha o tētahi rārangi raraunga mā te" + +#, python-format +msgid "The host \"%(hostname)s\" might be down and can't be reached." +msgstr "Kua heke pea te tūmau \"%(hostname)s\", ā, kāore e taea te toro atu." + +#, python-format +msgid "" +"The host \"%(hostname)s\" might be down, and can't be reached on port " +"%(port)s." +msgstr "" +"Kua heke pea te tūmau \"%(hostname)s\", ā, kāore e taea te toro atu i te " +"tauranga %(port)s." + +msgid "The host might be down, and can't be reached on the provided port." +msgstr "" +"Kua heke pea te tūmau, ā, kāore e taea te toro atu i te tauranga kua tukuna." + +#, python-format +msgid "The hostname \"%(hostname)s\" cannot be resolved." +msgstr "Kāore e taea te whakaoti i te ingoa tūmau \"%(hostname)s\"." + +msgid "The hostname provided can't be resolved." +msgstr "Kāore e taea te whakaoti i te ingoa tūmau kua tukuna." + +msgid "The id of the active chart" +msgstr "Te id o te kauwhata hohe" + +msgid "The layer attribution" +msgstr "Te whakatuakī papa" + +msgid "The lower limit of the threshold range of the Isoband" +msgstr "Te tepe raro o te awhe paepae o te Isoband" + +msgid "" +"The maximum number of subdivisions of each group; lower values are pruned " +"first" +msgstr "" +"Te maha rahi o ngā wāhangahanga o ia rōpū; ka purua ngā uara raro i te " +"tuatahi" + +msgid "The maximum value of metrics. It is an optional configuration" +msgstr "Te uara rahi o ngā ine. He whirihora kōwhiringa" + +#, python-format +msgid "" +"The metadata_params in Extra field is not configured correctly. The key " +"%(key)s is invalid." +msgstr "" +"Kāore i whirihorahia tika te metadata_params i te āpure Taapiri. He muhu te " +"kī %(key)s." + +msgid "" +"The metadata_params in Extra field is not configured correctly. The key " +"%{key}s is invalid." +msgstr "" +"Kāore i whirihorahia tika te metadata_params i te āpure Taapiri. He muhu te " +"kī %{key}s." + +msgid "" +"The metadata_params object gets unpacked into the sqlalchemy.MetaData call." +msgstr "Ka wewetea te ahanoa metadata_params ki te waea sqlalchemy.MetaData." + +msgid "" +"The minimum number of rolling periods required to show a value. For instance" +" if you do a cumulative sum on 7 days you may want your \"Min Period\" to be" +" 7, so that all data points shown are the total of 7 periods. This will hide" +" the \"ramp up\" taking place over the first 7 periods" +msgstr "" +"Te maha iti o ngā wā takahuri e hiahiatia ana hei whakaatu i tētahi uara. " +"Hei tauira mēnā ka mahi koe i tētahi tapeke whakakōputu i runga i te 7 rā ka" +" hiahia pea koe kia 7 tō \"Wā Iti\", kia noho katoa ngā tohu raraunga e " +"whakaaturia ana hei tapeke o ngā wā 7. Ka huna tēnei i te \"kokenga piki\" e" +" puta ana i runga i ngā wā 7 tuatahi" + +msgid "" +"The minimum value of metrics. It is an optional configuration. If not set, " +"it will be the minimum value of the data" +msgstr "" +"Te uara iti o ngā ine. He whirihora kōwhiringa. Mēnā kāore i tautuhia, ko te" +" uara iti o ngā raraunga" + +msgid "The name of the geometry column" +msgstr "Te ingoa o te tīwae āhuahanga" + +msgid "The name of the layer as described in GetCapabilities" +msgstr "Te ingoa o te papa e whakamāramahia ana i GetCapabilities" + +msgid "The name of the rule must be unique" +msgstr "Me ahurei te ingoa o te ture" + +msgid "The number color \"steps\"" +msgstr "Te maha o ngā \"takahanga\" tae" + +msgid "The number of bins for the histogram" +msgstr "Te maha o ngā pouaka mō te kauwhata auau" + +msgid "" +"The number of hours, negative or positive, to shift the time column. This " +"can be used to move UTC time to local time." +msgstr "" +"Te maha o ngā hāora, kino, pai rānei, hei neke i te tīwae wā. Ka taea te " +"whakamahi i tēnei hei neke i te wā UTC ki te wā ā-rohe." + +#, python-format +msgid "" +"The number of results displayed is limited to %(rows)d by the configuration " +"DISPLAY_MAX_ROW. Please add additional limits/filters or download to csv to " +"see more rows up to the %(limit)d limit." +msgstr "" +"Ka whakawhāititia te maha o ngā hua kua whakaaturia ki %(rows)d e te " +"whirihora DISPLAY_MAX_ROW. Tēnā tāpiri i ngā tepe/tātari taapiri, tikiake " +"rānei ki csv hei kite i ngā rārangi atu tae noa ki te tepe %(limit)d." + +#, python-format +msgid "" +"The number of results displayed is limited to %(rows)d. Please add " +"additional limits/filters, download to csv, or contact an admin to see more " +"rows up to the %(limit)d limit." +msgstr "" +"Ka whakawhāititia te maha o ngā hua kua whakaaturia ki %(rows)d. Tēnā tāpiri" +" i ngā tepe/tātari taapiri, tikiake ki csv, whakapā atu rānei ki tētahi " +"kaiwhakahaere hei kite i ngā rārangi atu tae noa ki te tepe %(limit)d." + +#, python-format +msgid "The number of rows displayed is limited to %(rows)d by the dropdown." +msgstr "" +"Ka whakawhāititia te maha o ngā rārangi kua whakaaturia ki %(rows)d e te " +"taka iho." + +#, python-format +msgid "" +"The number of rows displayed is limited to %(rows)d by the limit dropdown." +msgstr "" +"Ka whakawhāititia te maha o ngā rārangi kua whakaaturia ki %(rows)d e te " +"taka iho tepe." + +#, python-format +msgid "The number of rows displayed is limited to %(rows)d by the query" +msgstr "" +"Ka whakawhāititia te maha o ngā rārangi kua whakaaturia ki %(rows)d e te " +"pātai" + +#, python-format +msgid "" +"The number of rows displayed is limited to %(rows)d by the query and limit " +"dropdown." +msgstr "" +"Ka whakawhāititia te maha o ngā rārangi kua whakaaturia ki %(rows)d e te " +"pātai me te taka iho tepe." + +msgid "The number of seconds before expiring the cache" +msgstr "Te maha o ngā hēkona i mua i te pauhanga o te keteroki" + +msgid "The object does not exist in the given database." +msgstr "Karekau te ahanoa i roto i te pātengi raraunga kua tukuna." + +#, python-format +msgid "The parameter %(parameters)s in your query is undefined." +msgid_plural "" +"The following parameters in your query are undefined: %(parameters)s." +msgstr[0] "Kāore i tautuhia te tawhā %(parameters)s i tō pātai." +msgstr[1] "Kāore i tautuhia ēnei tawhā i tō pātai: %(parameters)s." + +#, python-format +msgid "The password provided for username \"%(username)s\" is incorrect." +msgstr "He hē te kupuhipa kua tukuna mō te ingoa kaiwhakamahi \"%(username)s\"." + +msgid "The password provided when connecting to a database is not valid." +msgstr "" +"Karekau e whaimana te kupuhipa kua tukuna ina hono ki tētahi pātengi " +"raraunga." + +msgid "" +"The passwords for the databases below are needed in order to import them " +"together with the charts. Please note that the \"Secure Extra\" and " +"\"Certificate\" sections of the database configuration are not present in " +"export files, and should be added manually after the import if they are " +"needed." +msgstr "" +"E hiahiatia ana ngā kupuhipa mō ngā pātengi raraunga i raro nei hei kawemai " +"i a rātou tahi me ngā kauwhata. Tēnā kia mōhio karekau ngā wāhanga \"Taapiri" +" Haumaru\" me \"Tiwhikete\" o te whirihora pātengi raraunga i roto i ngā " +"kōnae kaweatu, ā, me tāpiri ā-ringa i muri i te kawemai mēnā e hiahiatia " +"ana." + +msgid "" +"The passwords for the databases below are needed in order to import them " +"together with the dashboards. Please note that the \"Secure Extra\" and " +"\"Certificate\" sections of the database configuration are not present in " +"export files, and should be added manually after the import if they are " +"needed." +msgstr "" +"E hiahiatia ana ngā kupuhipa mō ngā pātengi raraunga i raro nei hei kawemai " +"i a rātou tahi me ngā papatohu. Tēnā kia mōhio karekau ngā wāhanga \"Taapiri" +" Haumaru\" me \"Tiwhikete\" o te whirihora pātengi raraunga i roto i ngā " +"kōnae kaweatu, ā, me tāpiri ā-ringa i muri i te kawemai mēnā e hiahiatia " +"ana." + +msgid "" +"The passwords for the databases below are needed in order to import them " +"together with the datasets. Please note that the \"Secure Extra\" and " +"\"Certificate\" sections of the database configuration are not present in " +"export files, and should be added manually after the import if they are " +"needed." +msgstr "" +"E hiahiatia ana ngā kupuhipa mō ngā pātengi raraunga i raro nei hei kawemai " +"i a rātou tahi me ngā rārangi raraunga. Tēnā kia mōhio karekau ngā wāhanga " +"\"Taapiri Haumaru\" me \"Tiwhikete\" o te whirihora pātengi raraunga i roto " +"i ngā kōnae kaweatu, ā, me tāpiri ā-ringa i muri i te kawemai mēnā e " +"hiahiatia ana." + +msgid "" +"The passwords for the databases below are needed in order to import them " +"together with the saved queries. Please note that the \"Secure Extra\" and " +"\"Certificate\" sections of the database configuration are not present in " +"export files, and should be added manually after the import if they are " +"needed." +msgstr "" +"E hiahiatia ana ngā kupuhipa mō ngā pātengi raraunga i raro nei hei kawemai " +"i a rātou tahi me ngā pātai kua tiakina. Tēnā kia mōhio karekau ngā wāhanga " +"\"Taapiri Haumaru\" me \"Tiwhikete\" o te whirihora pātengi raraunga i roto " +"i ngā kōnae kaweatu, ā, me tāpiri ā-ringa i muri i te kawemai mēnā e " +"hiahiatia ana." + +msgid "" +"The passwords for the databases below are needed in order to import them. " +"Please note that the \"Secure Extra\" and \"Certificate\" sections of the " +"database configuration are not present in explore files and should be added " +"manually after the import if they are needed." +msgstr "" +"E hiahiatia ana ngā kupuhipa mō ngā pātengi raraunga i raro nei hei kawemai " +"i a rātou. Tēnā kia mōhio karekau ngā wāhanga \"Taapiri Haumaru\" me " +"\"Tiwhikete\" o te whirihora pātengi raraunga i roto i ngā kōnae tūhura, ā, " +"me tāpiri ā-ringa i muri i te kawemai mēnā e hiahiatia ana." + +msgid "The pattern of timestamp format. For strings use " +msgstr "Te tauira o te hōputu waitohu. Mō ngā aho whakamahi " + +msgid "" +"The periodicity over which to pivot time. Users can provide\n" +" \"Pandas\" offset alias.\n" +" Click on the info bubble for more details on accepted \"freq\" expressions." +msgstr "" +"Te wātanga i runga i te hurihuri i te wā. Ka taea e ngā kaiwhakamahi te " +"whakarato i te" + +msgid "The pixel radius" +msgstr "Te pūtoro pika" + +msgid "" +"The pointer to a physical table (or view). Keep in mind that the chart is " +"associated to this Superset logical table, and this logical table points the" +" physical table referenced here." +msgstr "" +"Te tohu ki tētahi ripanga kikokiko (tirohanga rānei). Kia mahara ko te " +"kauwhata e hāngai ana ki tēnei ripanga arorau Superset, ā, ko tēnei ripanga " +"arorau e tohu ana i te ripanga kikokiko e tohutorohia ana ki konei." + +msgid "The port is closed." +msgstr "Kua katia te tauranga." + +msgid "The port number is invalid." +msgstr "He muhu te tau tauranga." + +msgid "The primary metric is used to define the arc segment sizes" +msgstr "Ka whakamahia te ine matua hei tautuhi i ngā rahi wāhanga kopeka" + +msgid "The provided table was not found in the provided database" +msgstr "Kāore i kitea te ripanga kua tukuna i te pātengi raraunga kua tukuna" + +msgid "The query associated with the results was deleted." +msgstr "I mukua te pātai e hāngai ana ki ngā hua." + +msgid "" +"The query associated with these results could not be found. You need to re-" +"run the original query." +msgstr "" +"Kāore i kitea te pātai e hāngai ana ki ēnei hua. Me whakahaere anō koe i te " +"pātai taketake." + +msgid "The query contains one or more malformed template parameters." +msgstr "Kei roto i te pātai tētahi, nui ake rānei tawhā tauira kua hē." + +msgid "The query couldn't be loaded" +msgstr "Kāore i taea te uta i te pātai" + +#, python-format +msgid "" +"The query estimation was killed after %(sqllab_timeout)s seconds. It might " +"be too complex, or the database might be under heavy load." +msgstr "" +"I whakamatea te tauwhitinga pātai i muri i ngā hēkona %(sqllab_timeout)s. He" +" uaua rawa pea, kua taimaha rawa rānei te pātengi raraunga." + +msgid "The query has a syntax error." +msgstr "He hapa wetereo tō te pātai." + +msgid "The query returned no data" +msgstr "Kāore i whakahoki raraunga te pātai" + +#, python-format +msgid "" +"The query was killed after %(sqllab_timeout)s seconds. It might be too " +"complex, or the database might be under heavy load." +msgstr "" +"I whakamatea te pātai i muri i ngā hēkona %(sqllab_timeout)s. He uaua rawa " +"pea, kua taimaha rawa rānei te pātengi raraunga." + +msgid "" +"The radius (in pixels) the algorithm uses to define a cluster. Choose 0 to " +"turn off clustering, but beware that a large number of points (>1000) will " +"cause lag." +msgstr "" +"Te pūtoro (i ngā pika) ka whakamahia e te hātepe hei tautuhi i tētahi " +"rāpaki. Kōwhiria 0 hei whakakore i te rāpaki, engari kia tūpato ka puta te " +"tatari mēnā he nui ngā tohu (>1000)." + +msgid "" +"The radius of individual points (ones that are not in a cluster). Either a " +"numerical column or `Auto`, which scales the point based on the largest " +"cluster" +msgstr "" +"Te pūtoro o ngā tohu takitahi (kāore i roto i tētahi rāpaki). He tīwae tau, " +"`Auto` rānei, ka tauine i te tohu i runga i te rāpaki nui rawa" + +msgid "The report has been created" +msgstr "Kua hangaia te pūrongo" + +msgid "The report will be sent to your email at" +msgstr "Ka tukuna te pūrongo ki tō īmēra i" + +msgid "" +"The result of this query must be a value capable of numeric interpretation " +"e.g. 1, 1.0, or \"1\" (compatible with Python's float() function)." +msgstr "Kua nui rawa atu te rahi hua i te tepe e whakāetia ana." + +msgid "The result size exceeds the allowed limit." +msgstr "Kāore anō i te tuarongo hua ngā raraunga mai i te pātai." + +msgid "The results backend no longer has the data from the query." +msgstr "" +"I penapena ngā hua i penapena ki te tuarongo i tētahi hōputu rerekē, ā, " +"kāore e taea te whakaoti." + +msgid "" +"The results stored in the backend were stored in a different format, and no " +"longer can be deserialized." +msgstr "" +"Ka whakaatu te kītukutuku whai rawa i tētahi rārangi o ngā raupapa katoa mō " +"taua tohu wā" + +msgid "The rich tooltip shows a list of all series for that point in time" +msgstr "" +"I tae ki te tepe rārangi kua tautuhia mō te kauwhata. Ka taea pea e te " +"kauwhata te whakaatu i ētahi raraunga anake." + +msgid "" +"The row limit set for the chart was reached. The chart may show partial " +"data." +msgstr "" +"I tae ki te tepe rārangi kua tautuhia mō te kauwhata. Ka taea pea e te " +"kauwhata te whakaatu i ētahi raraunga anake." + +#, python-format +msgid "" +"The schema \"%(schema)s\" does not exist. A valid schema must be used to run" +" this query." +msgstr "" +"Karekau te hanga \"%(schema)s\". Me whakamahi i tētahi hanga whaimana hei " +"whakahaere i tēnei pātai." + +#, python-format +msgid "" +"The schema \"%(schema_name)s\" does not exist. A valid schema must be used " +"to run this query." +msgstr "" +"Karekau te hanga \"%(schema_name)s\". Me whakamahi i tētahi hanga whaimana " +"hei whakahaere i tēnei pātai." + +msgid "The schema of the submitted payload is invalid." +msgstr "He muhu te hanga o te uta kua tukuna." + +msgid "The schema was deleted or renamed in the database." +msgstr "I mukua, i whakaingoahia-anō rānei te hanga i te pātengi raraunga." + +msgid "The screenshot could not be downloaded. Please, try again later." +msgstr "" +"Kāore i taea te tikiake i te hopuataata. Tēnā whakamātauhia anō ā muri ake " +"nei." + +msgid "The screenshot has been downloaded." +msgstr "Kua tikiake te hopuataata." + +msgid "The screenshot is being generated. Please, do not leave the page." +msgstr "Kei te hangaia te hopuataata. Tēnā kaua e waiho i te whārangi." + +msgid "The service url of the layer" +msgstr "Te url ratonga o te papa" + +msgid "The size of each cell in meters" +msgstr "Te rahi o ia pūtau i ngā mita" + +msgid "The size of the square cell, in pixels" +msgstr "Te rahi o te pūtau tapawhā rite, i ngā pika" + +msgid "The slope to compute all sizes from. \"LINEAR\" only" +msgstr "Te taha hei tatau i ngā rahi katoa. \"LINEAR\" anake" + +msgid "The submitted payload failed validation." +msgstr "I rahua te manatokotanga o te uta kua tukuna." + +msgid "The submitted payload has the incorrect format." +msgstr "He hōputu hē tō te uta kua tukuna." + +msgid "The submitted payload has the incorrect schema." +msgstr "He hanga hē tō te uta kua tukuna." + +#, python-format +msgid "" +"The table \"%(table)s\" does not exist. A valid table must be used to run " +"this query." +msgstr "" +"Karekau te ripanga \"%(table)s\". Me whakamahi i tētahi ripanga whaimana hei" +" whakahaere i tēnei pātai." + +#, python-format +msgid "" +"The table \"%(table_name)s\" does not exist. A valid table must be used to " +"run this query." +msgstr "" +"Karekau te ripanga \"%(table_name)s\". Me whakamahi i tētahi ripanga " +"whaimana hei whakahaere i tēnei pātai." + +msgid "The table was deleted or renamed in the database." +msgstr "I mukua, i whakaingoahia-anō rānei te ripanga i te pātengi raraunga." + +msgid "" +"The time column for the visualization. Note that you can define arbitrary " +"expression that return a DATETIME column in the table. Also note that the " +"filter below is applied against this column or expression" +msgstr "" +"Te tīwae wā mō te whakakitenga. Kia mōhio ka taea e koe te tautuhi i tētahi " +"kīanga noa e whakahoki ana i tētahi tīwae DATETIME i te ripanga. Kia mōhio " +"hoki ka whakahaeretia te tātari i raro nei ki tēnei tīwae, ki tēnei kīanga " +"rānei" + +msgid "" +"The time granularity for the visualization. Note that you can type and use " +"simple natural language as in `10 seconds`, `1 day` or `56 weeks`" +msgstr "" +"Te māeneene wā mō te whakakitenga. Kia mōhio ka taea e koe te pato me te " +"whakamahi i te reo māori māmā pērā i te `10 hēkona`, `1 rā`, `56 wiki` rānei" + +msgid "" +"The time granularity for the visualization. Note that you can type and use " +"simple natural language as in `10 seconds`,`1 day` or `56 weeks`" +msgstr "" +"Te māeneene wā mō te whakakitenga. Kia mōhio ka taea e koe te pato me te " +"whakamahi i te reo māori māmā pērā i te `10 hēkona`,`1 rā`, `56 wiki` rānei" + +msgid "" +"The time granularity for the visualization. This applies a date " +"transformation to alter your time column and defines a new time granularity." +" The options here are defined on a per database engine basis in the Superset" +" source code." +msgstr "" +"Te māeneene wā mō te whakakitenga. Ka whakahaeretia e tēnei he whakawhitinga" +" rā hei huri i tō tīwae wā, ā, ka tautuhi i tētahi māeneene wā hou. Ko ngā " +"kōwhiringa i konei kua tautuhia i runga i te pūkaha pātengi raraunga ia i " +"roto i te waehere puna Superset." + +msgid "" +"The time range for the visualization. All relative times, e.g. \"Last " +"month\", \"Last 7 days\", \"now\", etc. are evaluated on the server using " +"the server's local time (sans timezone). All tooltips and placeholder times " +"are expressed in UTC (sans timezone). The timestamps are then evaluated by " +"the database using the engine's local timezone. Note one can explicitly set " +"the timezone per the ISO 8601 format if specifying either the start and/or " +"end time." +msgstr "" +"Te awhe wā mō te whakakitenga. Ko ngā wā tata katoa, hei tauira \"Te marama " +"whakamutunga\", \"Ngā rā 7 whakamutunga\", \"ināianei\", me ērā atu ka " +"aromatawaitia i te tūmau mā te whakamahi i te wā ā-rohe o te tūmau (kore " +"rohe wā). Ka whakaaturia ngā kītukutuku katoa me ngā wā tohu-wāhi i te UTC " +"(kore rohe wā). Ka aromatawaitia ngā waitohu e te pātengi raraunga mā te " +"whakamahi i te rohe wā ā-rohe o te pūkaha. Kia mōhio ka taea e te tangata te" +" tautuhi ā-rohe i te rohe wā mā te hōputu ISO 8601 mēnā e tohu ana i te wā " +"tīmata me/rānei te wā mutunga." + +msgid "" +"The time unit for each block. Should be a smaller unit than " +"domain_granularity. Should be larger or equal to Time Grain" +msgstr "" +"Te waeine wā mō ia poraka. Me iti ake i te domain_granularity. Me rahi ake, " +"ōrite rānei ki te Māeneene Wā" + +msgid "The time unit used for the grouping of blocks" +msgstr "Te waeine wā ka whakamahia mō te rōpūtanga o ngā poraka" + +msgid "The type of the layer" +msgstr "Te momo o te papa" + +msgid "The type of visualization to display" +msgstr "Te momo whakakitenga hei whakaatu" + +msgid "The unit of measure for the specified point radius" +msgstr "Te waeine ine mō te pūtoro tohu kua tohua" + +msgid "The upper limit of the threshold range of the Isoband" +msgstr "Te tepe runga o te awhe paepae o te Isoband" + +msgid "The user seems to have been deleted" +msgstr "Kua mukua pea te kaiwhakamahi" + +msgid "" +"The user/password combination is not valid (Incorrect password for user)." +msgstr "" +"Kāore e whaimana te whakakotahitanga kaiwhakamahi/kupuhipa (Kupuhipa hē mō " +"te kaiwhakamahi)." + +#, python-format +msgid "The username \"%(username)s\" does not exist." +msgstr "Karekau te ingoa kaiwhakamahi \"%(username)s\"." + +msgid "The username provided when connecting to a database is not valid." +msgstr "" +"Kāore e whaimana te ingoa kaiwhakamahi i whakaratohia ina hono ki tētahi " +"pātengi raraunga." + +msgid "The version of the service" +msgstr "Te putanga o te ratonga" + +msgid "The visible title of the layer" +msgstr "Te taitara kite o te papa" + +msgid "The way the ticks are laid out on the X-axis" +msgstr "Te huarahi ka whakatakotohia ai ngā tika i te tukutuku-X" + +msgid "The width of the Isoline in pixels" +msgstr "Te whānui o te Isoline i ngā pika" + +msgid "The width of the current zoom level to compute all widths from" +msgstr "Te whānui o te taumata topa o nāianei hei tatau i ngā whānui katoa" + +msgid "The width of the elements border" +msgstr "Te whānui o te tapa o ngā huānga" + +msgid "The width of the lines" +msgstr "Te whānui o ngā rārangi" + +msgid "There are associated alerts or reports" +msgstr "He matohi, he pūrongo rānei e hono ana" + +#, python-format +msgid "There are associated alerts or reports: %(report_names)s" +msgstr "He matohi, he pūrongo rānei e hono ana: %(report_names)s" + +msgid "There are no charts added to this dashboard" +msgstr "Kāore he kauwhata kua tāpiritia ki tēnei papatohu" + +msgid "There are no components added to this tab" +msgstr "Kāore he waeine kua tāpiritia ki tēnei ripa" + +msgid "There are no filters in this dashboard." +msgstr "Kāore he tātari i roto i tēnei papatohu." + +msgid "There are unsaved changes." +msgstr "He huringa kāore anō kia tiakina." + +msgid "" +"There is a syntax error in the SQL query. Perhaps there was a misspelling or" +" a typo." +msgstr "He hapa wetereo i te pātai SQL. I hē pea te pūwaea, he pato rānei." + +msgid "There is currently no information to display." +msgstr "Kāore he mōhiohio hei whakaatu i tēnei wā." + +msgid "" +"There is no chart definition associated with this component, could it have " +"been deleted?" +msgstr "" +"Karekau he tautuhinga kauwhata e hāngai ana ki tēnei waeine, i mukua pea?" + +msgid "" +"There is not enough space for this component. Try decreasing its width, or " +"increasing the destination width." +msgstr "" +"Karekau he wāhi nui rawa mō tēnei waeine. Whakamātauhia te whakaiti i tōna " +"whānui, te whakanui rānei i te whānui wāhi tae." + +msgid "There was an error fetching dataset" +msgstr "I puta he hapa i te tikitanga o te rārangi raraunga" + +msgid "There was an error fetching dataset's related objects" +msgstr "" +"I puta he hapa i te tikitanga o ngā ahanoa hāngai o te rārangi raraunga" + +#, python-format +msgid "There was an error fetching the favorite status: %s" +msgstr "I puta he hapa i te tikitanga o te tūnga makau: %s" + +msgid "There was an error fetching the filtered charts and dashboards:" +msgstr "" +"I puta he hapa i te tikitanga o ngā kauwhata me ngā papatohu kua tātaritia:" + +msgid "There was an error generating the permalink." +msgstr "I puta he hapa i te hangarautanga o te hononga-ā-mau." + +msgid "There was an error loading the catalogs" +msgstr "I puta he hapa i te utanga o ngā kātaloka" + +msgid "There was an error loading the chart data" +msgstr "I puta he hapa i te utanga o ngā raraunga kauwhata" + +msgid "There was an error loading the dataset metadata" +msgstr "I puta he hapa i te utanga o te metadata rārangi raraunga" + +msgid "There was an error loading the schemas" +msgstr "I puta he hapa i te utanga o ngā hanga" + +msgid "There was an error loading the tables" +msgstr "I puta he hapa i te utanga o ngā ripanga" + +msgid "There was an error retrieving dashboard tabs." +msgstr "I puta he hapa i te tikitanga o ngā ripa papatohu." + +#, python-format +msgid "There was an error saving the favorite status: %s" +msgstr "I puta he hapa i te tiakitanga o te tūnga makau: %s" + +msgid "There was an error with your request" +msgstr "I puta he hapa ki tō tono" + +#, python-format +msgid "There was an issue deleting %s" +msgstr "I puta he take i te mukutanga o %s" + +#, python-format +msgid "There was an issue deleting %s: %s" +msgstr "I puta he take i te mukutanga o %s: %s" + +#, python-format +msgid "There was an issue deleting rules: %s" +msgstr "I puta he take i te mukutanga o ngā ture: %s" + +#, python-format +msgid "There was an issue deleting the selected %s: %s" +msgstr "I puta he take i te mukutanga o %s kua tīpakohia: %s" + +#, python-format +msgid "There was an issue deleting the selected annotations: %s" +msgstr "I puta he take i te mukutanga o ngā tohu kua tīpakohia: %s" + +#, python-format +msgid "There was an issue deleting the selected charts: %s" +msgstr "I puta he take i te mukutanga o ngā kauwhata kua tīpakohia: %s" + +msgid "There was an issue deleting the selected dashboards: " +msgstr "I puta he take i te mukutanga o ngā papatohu kua tīpakohia: " + +#, python-format +msgid "There was an issue deleting the selected datasets: %s" +msgstr "" +"I puta he take i te mukutanga o ngā rārangi raraunga kua tīpakohia: %s" + +#, python-format +msgid "There was an issue deleting the selected layers: %s" +msgstr "I puta he take i te mukutanga o ngā papa kua tīpakohia: %s" + +#, python-format +msgid "There was an issue deleting the selected queries: %s" +msgstr "I puta he take i te mukutanga o ngā pātai kua tīpakohia: %s" + +#, python-format +msgid "There was an issue deleting the selected templates: %s" +msgstr "I puta he take i te mukutanga o ngā tauira kua tīpakohia: %s" + +#, python-format +msgid "There was an issue deleting: %s" +msgstr "I puta he take i te mukutanga: %s" + +msgid "There was an issue duplicating the dataset." +msgstr "I puta he take i te tāruatanga o te rārangi raraunga." + +#, python-format +msgid "There was an issue duplicating the selected datasets: %s" +msgstr "" +"I puta he take i te tāruatanga o ngā rārangi raraunga kua tīpakohia: %s" + +msgid "There was an issue favoriting this dashboard." +msgstr "I puta he take i te whakamakauhanga o tēnei papatohu." + +msgid "There was an issue fetching reports attached to this dashboard." +msgstr "" +"I puta he take i te tikitanga o ngā pūrongo kua tāpiritia ki tēnei papatohu." + +msgid "There was an issue fetching the favorite status of this dashboard." +msgstr "I puta he take i te tikitanga o te tūnga makau o tēnei papatohu." + +#, python-format +msgid "There was an issue fetching your chart: %s" +msgstr "I puta he take i te tikitanga o tō kauwhata: %s" + +#, python-format +msgid "There was an issue fetching your dashboards: %s" +msgstr "I puta he take i te tikitanga o ō papatohu: %s" + +#, python-format +msgid "There was an issue fetching your recent activity: %s" +msgstr "I puta he take i te tikitanga o ō hohenga tata nei: %s" + +#, python-format +msgid "There was an issue fetching your saved queries: %s" +msgstr "I puta he take i te tikitanga o ō pātai kua tiakina: %s" + +#, python-format +msgid "There was an issue previewing the selected query %s" +msgstr "I puta he take i te arokitenga o te pātai kua tīpakohia %s" + +#, python-format +msgid "There was an issue previewing the selected query. %s" +msgstr "I puta he take i te arokitenga o te pātai kua tīpakohia. %s" + +msgid "These are the datasets this filter will be applied to." +msgstr "Ko ēnei ngā rārangi raraunga ka whakahaeretia ki reira tēnei tātari." + +msgid "" +"This JSON object is generated dynamically when clicking the save or " +"overwrite button in the dashboard view. It is exposed here for reference and" +" for power users who may want to alter specific parameters." +msgstr "" +"Ka hangaia aunoa tēnei ahanoa JSON ina pāwhiria te pātene tiaki, tuhirua " +"rānei i te tirohanga papatohu. Kua whakaaturia ki konei hei tohutoro me ngā " +"kaiwhakamahi kaha ka hiahia pea ki te huri i ētahi tawhā motuhake." + +#, python-format +msgid "This action will permanently delete %s." +msgstr "Mā tēnei mahi ka mukua pūmau %s." + +msgid "This action will permanently delete the layer." +msgstr "Mā tēnei mahi ka mukua pūmau te papa." + +msgid "This action will permanently delete the role." +msgstr "Mā tēnei mahi ka mukua pūmau te tūranga." + +msgid "This action will permanently delete the saved query." +msgstr "Mā tēnei mahi ka mukua pūmau te pātai kua tiakina." + +msgid "This action will permanently delete the template." +msgstr "Mā tēnei mahi ka mukua pūmau te tauira." + +msgid "This action will permanently delete the user." +msgstr "Mā tēnei mahi ka mukua pūmau te kaiwhakamahi." + +msgid "" +"This can be either an IP address (e.g. 127.0.0.1) or a domain name (e.g. " +"mydatabase.com)." +msgstr "" +"Ka taea e tēnei te noho hei wāhitau IP (hei tauira 127.0.0.1), hei ingoa " +"rohe rānei (hei tauira mydatabase.com)." + +msgid "" +"This chart applies cross-filters to charts whose datasets contain columns " +"with the same name." +msgstr "" +"Ka whakahaeretia e tēnei kauwhata ngā tātari-whiti ki ngā kauwhata kei ō " +"rātou rārangi raraunga he tīwae me te ingoa ōrite." + +msgid "This chart has been moved to a different filter scope." +msgstr "Kua nekehia tēnei kauwhata ki tētahi korahi tātari rerekē." + +msgid "This chart is managed externally, and can't be edited in Superset" +msgstr "" +"Kei te whakahaere i waho tēnei kauwhata, ā, kāore e taea te whakatika i " +"Superset" + +msgid "" +"This chart might be incompatible with the filter (datasets don't match)" +msgstr "" +"Kāhore pea e hāngai tēnei kauwhata ki te tātari (karekau e hāngai ngā " +"rārangi raraunga)" + +msgid "" +"This chart type is not supported when using an unsaved query as a chart " +"source. " +msgstr "" +"Karekau e tautokona tēnei momo kauwhata ina whakamahi i tētahi pātai kāore " +"anō kia tiakina hei puna kauwhata. " + +msgid "This column might be incompatible with current dataset" +msgstr "Kāhore pea e hāngai tēnei tīwae ki te rārangi raraunga o nāianei" + +msgid "This column must contain date/time information." +msgstr "Me whai tēnei tīwae i ngā mōhiohio rā/wā." + +msgid "" +"This control filters the whole chart based on the selected time range. All " +"relative times, e.g. \"Last month\", \"Last 7 days\", \"now\", etc. are " +"evaluated on the server using the server's local time (sans timezone). All " +"tooltips and placeholder times are expressed in UTC (sans timezone). The " +"timestamps are then evaluated by the database using the engine's local " +"timezone. Note one can explicitly set the timezone per the ISO 8601 format " +"if specifying either the start and/or end time." +msgstr "" +"Ka tātari tēnei whakahaere i te kauwhata katoa i runga i te awhe wā kua " +"tīpakohia. Ko ngā wā tata katoa, hei tauira \"Te marama whakamutunga\", " +"\"Ngā rā 7 whakamutunga\", \"ināianei\", me ērā atu ka aromatawaitia i te " +"tūmau mā te whakamahi i te wā ā-rohe o te tūmau (kore rohe wā). Ka " +"whakaaturia ngā kītukutuku katoa me ngā wā tohu-wāhi i te UTC (kore rohe " +"wā). Ka aromatawaitia ngā waitohu e te pātengi raraunga mā te whakamahi i te" +" rohe wā ā-rohe o te pūkaha. Kia mōhio ka taea e te tangata te tautuhi " +"ā-rohe i te rohe wā mā te hōputu ISO 8601 mēnā e tohu ana i te wā tīmata " +"me/rānei te wā mutunga." + +msgid "" +"This controls whether the \"time_range\" field from the current\n" +" view should be passed down to the chart containing the annotation data." +msgstr "" +"Ka whakahaere tēnei mēnā me tuku iho rānei te āpure \"time_range\" mai i te" + +msgid "" +"This controls whether the time grain field from the current\n" +" view should be passed down to the chart containing the annotation data." +msgstr "" +"Ka whakahaere tēnei mēnā me tuku iho rānei te āpure māeneene wā mai i te" + +#, python-format +msgid "" +"This dashboard is currently auto refreshing; the next auto refresh will be " +"in %s." +msgstr "" +"Kei te whakahou aunoa tēnei papatohu i tēnei wā; ko te whakahou aunoa panuku" +" i roto i %s." + +msgid "This dashboard is managed externally, and can't be edited in Superset" +msgstr "" +"Kei te whakahaere i waho tēnei papatohu, ā, kāore e taea te whakatika i " +"Superset" + +msgid "" +"This dashboard is not published which means it will not show up in the list " +"of dashboards. Favorite it to see it there or access it by using the URL " +"directly." +msgstr "" +"Kāore tēnei papatohu kia whakaputaina, karekau e puta i te rārangi papatohu." +" Whakamakauhia kia kite i reira, urunga rānei mā te whakamahi i te URL " +"tōtika." + +msgid "" +"This dashboard is not published, it will not show up in the list of " +"dashboards. Click here to publish this dashboard." +msgstr "" +"Kāore tēnei papatohu kia whakaputaina, karekau e puta i te rārangi papatohu." +" Pāwhiria ki konei hei whakaputa i tēnei papatohu." + +msgid "This dashboard is now hidden" +msgstr "Kua hunaia tēnei papatohu i tēnei wā" + +msgid "This dashboard is now published" +msgstr "Kua whakaputaina tēnei papatohu i tēnei wā" + +msgid "This dashboard is published. Click to make it a draft." +msgstr "Kua whakaputaina tēnei papatohu. Pāwhiria hei hanga hei tuhinga." + +msgid "" +"This dashboard is ready to embed. In your application, pass the following id" +" to the SDK:" +msgstr "" +"Kei te reri tēnei papatohu hei tāmau. I roto i tō taupānga, tukua te id e " +"whai ake nei ki te SDK:" + +msgid "This dashboard was saved successfully." +msgstr "I tiakina pai tēnei papatohu." + +msgid "" +"This database does not allow for DDL/DML, and the query could not be parsed " +"to confirm it is a read-only query. Please contact your administrator for " +"more assistance." +msgstr "" +"Karekau tēnei pātengi raraunga e whakāe ana ki te DDL/DML, ā, kāore i taea " +"te poroporo i te pātai hei whakaū he pātai pānui-anake. Tēnā whakapā atu ki " +"tō kaiwhakahaere mō te āwhina." + +msgid "This database is managed externally, and can't be edited in Superset" +msgstr "" +"Kei te whakahaere i waho tēnei pātengi raraunga, ā, kāore e taea te " +"whakatika i Superset" + +msgid "" +"This database table does not contain any data. Please select a different " +"table." +msgstr "" +"Karekau he raraunga i roto i tēnei ripanga pātengi raraunga. Tēnā tīpakohia " +"tētahi ripanga rerekē." + +msgid "This dataset is managed externally, and can't be edited in Superset" +msgstr "" +"Kei te whakahaere i waho tēnei rārangi raraunga, ā, kāore e taea te " +"whakatika i Superset" + +msgid "This dataset is not used to power any charts." +msgstr "" +"Karekau tēnei rārangi raraunga e whakamahia ana hei whakamana i ngā " +"kauwhata." + +msgid "This defines the element to be plotted on the chart" +msgstr "Ka tautuhi tēnei i te huānga ka whakatakotohia ki te kauwhata" + +msgid "This email is already associated with an account." +msgstr "Kei te hono kē tēnei īmēra ki tētahi kaute." + +msgid "" +"This field is used as a unique identifier to attach the calculated dimension" +" to charts. It is also used as the alias in the SQL query." +msgstr "" +"Ka whakamahia tēnei āpure hei waitohu ahurei hei tāpiri i te āhuahanga tatau" +" ki ngā kauwhata. Ka whakamahia hoki hei ingoa-kē i te pātai SQL." + +msgid "" +"This field is used as a unique identifier to attach the metric to charts. It" +" is also used as the alias in the SQL query." +msgstr "" +"Ka whakamahia tēnei āpure hei waitohu ahurei hei tāpiri i te ine ki ngā " +"kauwhata. Ka whakamahia hoki hei ingoa-kē i te pātai SQL." + +msgid "This filter might be incompatible with current dataset" +msgstr "Kāhore pea e hāngai tēnei tātari ki te rārangi raraunga o nāianei" + +msgid "" +"This functionality is disabled in your environment for security reasons." +msgstr "Kua whakakore tēnei āheinga i tō taiao mō ngā take haumaru." + +msgid "" +"This is the condition that will be added to the WHERE clause. For example, " +"to only return rows for a particular client, you might define a regular " +"filter with the clause `client_id = 9`. To display no rows unless a user " +"belongs to a RLS filter role, a base filter can be created with the clause " +"`1 = 0` (always false)." +msgstr "" +"Ko tēnei te āhuatanga ka tāpiritia ki te rerenga WHERE. Hei tauira, hei " +"whakahoki i ngā rārangi mō tētahi kiritaki motuhake, ka taea pea e koe te " +"tautuhi i tētahi tātari auau me te rerenga `client_id = 9`. Hei whakaatu i " +"ngā rārangi kore mēnā karekau te kaiwhakamahi e whai ana ki tētahi tūranga " +"tātari RLS, ka taea te hanga i tētahi tātari pūtake me te rerenga `1 = 0` " +"(teka i ngā wā katoa)." + +msgid "" +"This json object describes the positioning of the widgets in the dashboard. " +"It is dynamically generated when adjusting the widgets size and positions by" +" using drag & drop in the dashboard view" +msgstr "" +"Ka whakamārama tēnei ahanoa json i te tūnga o ngā waeine i te papatohu. Ka " +"hangaia autōkē ina whakatikatika i te rahi me ngā tūnga waeine mā te " +"whakamahi i te tō & taka i te tirohanga papatohu" + +msgid "This markdown component has an error." +msgstr "He hapa tā tēnei waeine markdown." + +msgid "" +"This markdown component has an error. Please revert your recent changes." +msgstr "He hapa tā tēnei waeine markdown. Tēnā whakahokia ō huringa tata nei." + +msgid "This may be triggered by:" +msgstr "Ka taea pea te whakaohongia e:" + +msgid "This metric might be incompatible with current dataset" +msgstr "Kāhore pea e hāngai tēnei ine ki te rārangi raraunga o nāianei" + +msgid "This option has been disabled by the administrator." +msgstr "Kua whakakore tēnei kōwhiringa e te kaiwhakahaere." + +msgid "" +"This page is intended to be embedded in an iframe, but it looks like that is" +" not the case." +msgstr "" +"Kua whakaritea tēnei whārangi hei tāmau i tētahi iframe, engari e rite ana " +"kāore tērā te take." + +msgid "" +"This section allows you to configure how to use the slice\n" +" to generate annotations." +msgstr "Kei roto i tēnei wāhanga ngā hapa manatoko" + +msgid "" +"This section contains options that allow for advanced analytical post " +"processing of query results" +msgstr "" +"Kei roto i tēnei wāhanga ngā kōwhiringa ka tukua mō te tukatuka-iho " +"tātaritanga aromatawai o ngā hua pātai" + +msgid "This section contains validation errors" +msgstr "Kei roto i tēnei wāhanga ngā hapa manatoko" + +msgid "" +"This session has encountered an interruption, and some controls may not work" +" as intended. If you are the developer of this app, please check that the " +"guest token is being generated correctly." +msgstr "" +"Kua tūtaki tēnei wātaka i tētahi whakararunga, ā, ka kore pea ētahi " +"whakahaere e mahi pērā i te tūmanako. Mēnā ko koe te kaiwhakawhanaketanga o " +"tēnei taupānga, tēnā tirohia kei te hanga tika te tohu manuhiri." + +msgid "This table already has a dataset" +msgstr "Kei tēnei ripanga kētia he rārangi raraunga" + +msgid "" +"This table already has a dataset associated with it. You can only associate " +"one dataset with a table.\n" +msgstr "" +"Kei tēnei ripanga kētia he rārangi raraunga e hāngai ana ki a ia. Kotahi " +"anake te rārangi raraunga ka taea te hono ki tētahi ripanga.\n" + +msgid "This username is already taken. Please choose another one." +msgstr "" +"Kua tangohia kētia tēnei ingoa kaiwhakamahi. Tēnā kōwhiria tētahi atu." + +msgid "This value should be greater than the left target value" +msgstr "Me rahi ake tēnei uara i te uara whāinga mauī" + +msgid "This value should be smaller than the right target value" +msgstr "Me iti ake tēnei uara i te uara whāinga matau" + +msgid "This visualization type does not support cross-filtering." +msgstr "Karekau tēnei momo whakakitenga e tautoko i te tātari-whiti." + +msgid "This visualization type is not supported." +msgstr "Karekau tēnei momo whakakitenga e tautokona." + +msgid "This was triggered by:" +msgid_plural "This may be triggered by:" +msgstr[0] "I whakaohongia tēnei e:" +msgstr[1] "Ka taea pea te whakaohongia e:" + +msgid "" +"This will be applied to the whole table. Arrows (↑ and ↓) will be added to " +"main columns for increase and decrease. Basic conditional formatting can be " +"overwritten by conditional formatting below." +msgstr "" +"Ka whakahaeretia tēnei ki te ripanga katoa. Ka tāpiritia ngā pere (↑ me ↓) " +"ki ngā tīwae matua mō te piki me te heke. Ka taea e te hōputu āhuatanga " +"taketake te tuhirua e te hōputu āhuatanga i raro nei." + +msgid "This will remove your current embed configuration." +msgstr "Mā tēnei ka tangohia tō whirihora tāmau o nāianei." + +msgid "Threshold" +msgstr "Paepae" + +msgid "Threshold alpha level for determining significance" +msgstr "Taumata paepae alpha mō te whakatau i te hiranga" + +msgid "Threshold: " +msgstr "Paepae: " + +msgid "Thumbnails" +msgstr "Pikitia iti" + +msgid "Thursday" +msgstr "Tāite" + +msgid "Time" +msgstr "Wā" + +msgid "Time Column" +msgstr "Tīwae Wā" + +msgid "Time Comparison" +msgstr "Whakatairite Wā" + +msgid "Time Format" +msgstr "Hōputu Wā" + +msgid "Time Grain" +msgstr "Māeneene Wā" + +msgid "Time Grain must be specified when using Time Shift." +msgstr "Me tohua te Māeneene Wā ina whakamahi i te Neke Wā." + +msgid "Time Granularity" +msgstr "Māeneene Wā" + +msgid "Time Lag" +msgstr "Takaroa Wā" + +msgid "Time Range" +msgstr "Awhe Wā" + +msgid "Time Ratio" +msgstr "Ōwehenga Wā" + +msgid "Time Series" +msgstr "Raupapa Wā" + +msgid "Time Series - Line Chart" +msgstr "Raupapa Wā - Kauwhata Rārangi" + +msgid "Time Series - Nightingale Rose Chart" +msgstr "Raupapa Wā - Kauwhata Rose Nightingale" + +msgid "Time Series - Paired t-test" +msgstr "Raupapa Wā - Whakamātau-t Takirua" + +msgid "Time Series - Percent Change" +msgstr "Raupapa Wā - Panoni Ōrau" + +msgid "Time Series - Period Pivot" +msgstr "Raupapa Wā - Hurihuri Wā" + +msgid "Time Series Options" +msgstr "Kōwhiringa Raupapa Wā" + +msgid "Time Shift" +msgstr "Neke Wā" + +msgid "Time Table View" +msgstr "Tirohanga Ripanga Wā" + +msgid "Time column" +msgstr "Tīwae wā" + +#, python-format +msgid "Time column \"%(col)s\" does not exist in dataset" +msgstr "Karekau te tīwae wā \"%(col)s\" i te rārangi raraunga" + +msgid "Time column filter plugin" +msgstr "Mono tātari tīwae wā" + +msgid "Time column to apply dependent temporal filter to" +msgstr "Tīwae wā hei whakahaeretia i te tātari wā whakawhirinaki" + +msgid "Time column to apply time range to" +msgstr "Tīwae wā hei whakahaeretia i te awhe wā" + +msgid "Time comparison" +msgstr "Whakatairite wā" + +msgid "" +"Time delta in natural language\n" +" (example: 24 hours, 7 days, 56 weeks, 365 days)" +msgstr "Hōputu wā" + +#, python-format +msgid "" +"Time delta is ambiguous. Please specify [%(human_readable)s ago] or " +"[%(human_readable)s later]." +msgstr "" +"He rangirua te rerekētanga wā. Tēnā tohua [%(human_readable)s i mua] " +"[%(human_readable)s ā muri ake nei] rānei." + +msgid "Time filter" +msgstr "Tātari wā" + +msgid "Time format" +msgstr "Hōputu wā" + +msgid "Time grain" +msgstr "Māeneene wā" + +msgid "Time grain filter plugin" +msgstr "Mono tātari māeneene wā" + +msgid "Time grain missing" +msgstr "Kei te ngaro te māeneene wā" + +msgid "Time granularity" +msgstr "Māeneene wā" + +msgid "Time in seconds" +msgstr "Wā i ngā hēkona" + +msgid "Time lag" +msgstr "Takaroa wā" + +msgid "Time range" +msgstr "Awhe wā" + +msgid "Time ratio" +msgstr "Ōwehenga wā" + +msgid "Time related form attributes" +msgstr "Āhuatanga puka hāngai wā" + +msgid "Time series" +msgstr "Raupapa wā" + +msgid "Time series columns" +msgstr "Tīwae raupapa wā" + +msgid "Time shift" +msgstr "Neke wā" + +#, python-format +msgid "" +"Time string is ambiguous. Please specify [%(human_readable)s ago] or " +"[%(human_readable)s later]." +msgstr "" +"He rangirua te aho wā. Tēnā tohua [%(human_readable)s i mua] " +"[%(human_readable)s ā muri ake nei] rānei." + +msgid "Time-series Percent Change" +msgstr "Panoni Ōrau Raupapa-wā" + +msgid "Time-series Period Pivot" +msgstr "Hurihuri Wā Raupapa-wā" + +msgid "Time-series Table" +msgstr "Ripanga Raupapa-wā" + +msgid "Timeout error" +msgstr "Hapa wā-pau" + +msgid "Timestamp format" +msgstr "Hōputu waitohu" + +msgid "Timezone" +msgstr "Rohe wā" + +msgid "Timezone selector" +msgstr "Kaitīpako rohe wā" + +msgid "Tiny" +msgstr "Iti rawa" + +msgid "Title" +msgstr "Taitara" + +msgid "Title Column" +msgstr "Tīwae Taitara" + +msgid "Title is required" +msgstr "E hiahiatia ana te taitara" + +msgid "Title or Slug" +msgstr "Taitara, Slug rānei" + +msgid "" +"To enable multiple column sorting, hold down the ⇧ Shift key while clicking " +"the column header." +msgstr "" +"Hei whakahohe i te kōmaka tīwae maha, pupuri i te kī ⇧ Shift i te wā e " +"pāwhiri ana i te pane tīwae." + +msgid "To filter on a metric, use Custom SQL tab." +msgstr "Hei tātari i tētahi ine, whakamahia te ripa SQL Ritenga." + +msgid "To get a readable URL for your dashboard" +msgstr "Hei whiwhi i tētahi URL ka taea te pānui mō tō papatohu" + +msgid "Tooltip" +msgstr "Kītukutuku" + +msgid "Tooltip Contents" +msgstr "Ihirangi Kītukutuku" + +msgid "Tooltip sort by metric" +msgstr "Kōmaka kītukutuku mā te ine" + +msgid "Tooltip time format" +msgstr "Hōputu wā kītukutuku" + +msgid "Top" +msgstr "Runga" + +msgid "Top left" +msgstr "Runga mauī" + +msgid "Top right" +msgstr "Runga matau" + +msgid "Top to Bottom" +msgstr "Runga ki Raro" + +msgid "Total" +msgstr "Tapeke" + +#, python-format +msgid "Total (%(aggfunc)s)" +msgstr "Tapeke (%(aggfunc)s)" + +#, python-format +msgid "Total (%(aggregatorName)s)" +msgstr "Tapeke (%(aggregatorName)s)" + +msgid "Total (Sum)" +msgstr "Tapeke (Tapeke)" + +msgid "Total value" +msgstr "Uara tapeke" + +#, python-format +msgid "Total: %s" +msgstr "Tapeke: %s" + +msgid "Track job" +msgstr "Whai mahi" + +msgid "Transformable" +msgstr "Ka taea te whakawhiti" + +msgid "Transparent" +msgstr "Ataata" + +msgid "Transpose pivot" +msgstr "Whakawhiti hurihuri" + +msgid "Treat values as categorical." +msgstr "Whakahaere i ngā uara hei kāwai." + +msgid "Tree Chart" +msgstr "Kauwhata Rākau" + +msgid "Tree layout" +msgstr "Hoahoa rākau" + +msgid "Tree orientation" +msgstr "Ahunga rākau" + +msgid "Treemap" +msgstr "Mahere Rākau" + +msgid "Trend" +msgstr "Ia" + +msgid "Triangle" +msgstr "Tapatoru" + +msgid "Trigger Alert If..." +msgstr "Whakaohongia te Matohi Mēnā..." + +msgid "Truncate Axis" +msgstr "Porohita Tukutuku" + +msgid "Truncate Cells" +msgstr "Porohita Pūtau" + +msgid "Truncate Metric" +msgstr "Porohita Ine" + +msgid "Truncate X Axis" +msgstr "Porohita Tukutuku X" + +msgid "" +"Truncate X Axis. Can be overridden by specifying a min or max bound. Only " +"applicable for numerical X axis." +msgstr "" +"Porohita Tukutuku X. Ka taea te whakakapi mā te tohu i te rohe iti, rohe " +"rahi rānei. Mō te tukutuku-X tau anake." + +msgid "Truncate Y Axis" +msgstr "Porohita Tukutuku Y" + +msgid "Truncate Y Axis. Can be overridden by specifying a min or max bound." +msgstr "" +"Porohita Tukutuku Y. Ka taea te whakakapi mā te tohu i te rohe iti, rohe " +"rahi rānei." + +msgid "Truncate long cells to the \"min width\" set above" +msgstr "Porohita i ngā pūtau roa ki te \"whānui iti\" kua tautuhia i runga" + +msgid "" +"Truncates the specified date to the accuracy specified by the date unit." +msgstr "Ka porohita i te rā kua tohua ki te tika kua tohua e te waeine rā." + +msgid "Try applying different filters or ensuring your datasource has data" +msgstr "" +"Whakamātauhia te whakahaeretia o ngā tātari rerekē, te whakaū rānei he " +"raraunga tō puna raraunga" + +msgid "Try different criteria to display results." +msgstr "Whakamātauhia ngā paearu rerekē hei whakaatu i ngā hua." + +msgid "Tuesday" +msgstr "Tūrei" + +msgid "Tukey" +msgstr "Tukey" + +msgid "Type" +msgstr "Momo" + +#, python-format +msgid "Type \"%s\" to confirm" +msgstr "Pato \"%s\" hei whakaū" + +msgid "Type a number" +msgstr "Pato tētahi tau" + +msgid "Type a value" +msgstr "Pato tētahi uara" + +msgid "Type a value here" +msgstr "Pato tētahi uara ki konei" + +msgid "Type is required" +msgstr "E hiahiatia ana te momo" + +msgid "Type of comparison, value difference or percentage" +msgstr "Momo whakatairite, rerekētanga uara, ōrau rānei" + +msgid "UI Configuration" +msgstr "Whirihora UI" + +msgid "URL" +msgstr "URL" + +msgid "URL Parameters" +msgstr "Tawhā URL" + +msgid "URL parameters" +msgstr "Tawhā url" + +msgid "URL slug" +msgstr "Slug URL" + +msgid "Unable to calculate such a date delta" +msgstr "Kāore e taea te tatau i tētahi rerekētanga rā pēnei" + +#, python-format +msgid "Unable to connect to catalog named \"%(catalog_name)s\"." +msgstr "Kāore e taea te hono ki te kātaloka ko \"%(catalog_name)s\" te ingoa." + +#, python-format +msgid "Unable to connect to database \"%(database)s\"." +msgstr "Kāore e taea te hono ki te pātengi raraunga \"%(database)s\"." + +msgid "" +"Unable to connect. Verify that the following roles are set on the service " +"account: \"BigQuery Data Viewer\", \"BigQuery Metadata Viewer\", \"BigQuery " +"Job User\" and the following permissions are set " +"\"bigquery.readsessions.create\", \"bigquery.readsessions.getData\"" +msgstr "" +"Kāore e taea te hono. Whakaūngia kua tautuhia ēnei tūranga i te kaute " +"ratonga: \"BigQuery Data Viewer\", \"BigQuery Metadata Viewer\", \"BigQuery " +"Job User\" me ēnei mōtika kua tautuhia \"bigquery.readsessions.create\", " +"\"bigquery.readsessions.getData\"" + +msgid "Unable to create chart without a query id." +msgstr "Kāore e taea te hanga kauwhata me te kore id pātai." + +msgid "Unable to decode value" +msgstr "Kāore e taea te whakaoti i te uara" + +msgid "Unable to encode value" +msgstr "Kāore e taea te whakakohu i te uara" + +#, python-format +msgid "Unable to find such a holiday: [%(holiday)s]" +msgstr "Kāore e taea te kimi i tētahi hararei pēnei: [%(holiday)s]" + +msgid "" +"Unable to load columns for the selected table. Please select a different " +"table." +msgstr "" +"Kāore e taea te uta i ngā tīwae mō te ripanga kua tīpakohia. Tēnā tīpakohia " +"tētahi ripanga rerekē." + +msgid "Unable to load dashboard" +msgstr "Kāore e taea te uta i te papatohu" + +msgid "" +"Unable to migrate query editor state to backend. Superset will retry later. " +"Please contact your administrator if this problem persists." +msgstr "" +"Kāore i taea te heke i te tūnga etita pātai ki te tuarongo. Ka whakamātau " +"anō a Superset ā muri ake nei. Tēnā whakapā atu ki tō kaiwhakahaere mēnā ka " +"mau tonu tēnei raru." + +msgid "" +"Unable to migrate query state to backend. Superset will retry later. Please " +"contact your administrator if this problem persists." +msgstr "" +"Kāore i taea te heke i te tūnga pātai ki te tuarongo. Ka whakamātau anō a " +"Superset ā muri ake nei. Tēnā whakapā atu ki tō kaiwhakahaere mēnā ka mau " +"tonu tēnei raru." + +msgid "" +"Unable to migrate table schema state to backend. Superset will retry later. " +"Please contact your administrator if this problem persists." +msgstr "" +"Kāore i taea te heke i te tūnga hanga ripanga ki te tuarongo. Ka whakamātau " +"anō a Superset ā muri ake nei. Tēnā whakapā atu ki tō kaiwhakahaere mēnā ka " +"mau tonu tēnei raru." + +msgid "Unable to parse SQL" +msgstr "Kāore e taea te poroporo i te SQL" + +msgid "Unable to retrieve dashboard colors" +msgstr "Kāore e taea te tiki i ngā tae papatohu" + +msgid "Unable to sync permissions for this database connection." +msgstr "" +"Kāore e taea te hāngai i ngā mōtika mō tēnei hononga pātengi raraunga." + +msgid "Undefined" +msgstr "Kāore i Tautuhia" + +msgid "Undefined window for rolling operation" +msgstr "Matapihi kāore i tautuhia mō te mahinga takahuri" + +msgid "Undo the action" +msgstr "Wetekina te mahi" + +msgid "Undo?" +msgstr "Wete?" + +msgid "Unexpected error" +msgstr "Hapa ohorere" + +msgid "Unexpected error occurred, please check your logs for details" +msgstr "I puta he hapa ohorere, tēnā tirohia ō rārangi mō ngā taipitopito" + +msgid "Unexpected error: " +msgstr "Hapa ohorere: " + +msgid "Unexpected no file extension found" +msgstr "Kāore i kitea he toronga kōnae ohorere" + +#, python-format +msgid "Unexpected time range: %(error)s" +msgstr "Awhe wā ohorere: %(error)s" + +msgid "Unhide" +msgstr "Whakaatuhia" + +msgid "Unknown" +msgstr "Kāore e Mōhiotia" + +#, python-format +msgid "Unknown Doris server host \"%(hostname)s\"." +msgstr "Tūmau tūmau Doris kāore e mōhiotia \"%(hostname)s\"." + +#, python-format +msgid "Unknown MySQL server host \"%(hostname)s\"." +msgstr "Tūmau tūmau MySQL kāore e mōhiotia \"%(hostname)s\"." + +#, python-format +msgid "Unknown OceanBase server host \"%(hostname)s\"." +msgstr "Tūmau tūmau OceanBase kāore e mōhiotia \"%(hostname)s\"." + +msgid "Unknown Presto Error" +msgstr "Hapa Presto Kāore e Mōhiotia" + +msgid "Unknown Status" +msgstr "Tūnga Kāore e Mōhiotia" + +#, python-format +msgid "Unknown column used in orderby: %(col)s" +msgstr "Tīwae kāore e mōhiotia i whakamahia i te orderby: %(col)s" + +msgid "Unknown error" +msgstr "Hapa kāore e mōhiotia" + +msgid "Unknown input format" +msgstr "Hōputu tāuru kāore e mōhiotia" + +msgid "Unknown type" +msgstr "Momo kāore e mōhiotia" + +msgid "Unknown value" +msgstr "Uara kāore e mōhiotia" + +msgid "Unpin" +msgstr "Wewete pine" + +#, python-format +msgid "Unsafe return type for function %(func)s: %(value_type)s" +msgstr "Momo whakahoki kore haumaru mō te taumahi %(func)s: %(value_type)s" + +#, python-format +msgid "Unsafe template value for key %(key)s: %(value_type)s" +msgstr "Uara tauira kore haumaru mō te kī %(key)s: %(value_type)s" + +#, python-format +msgid "Unsupported clause type: %(clause)s" +msgstr "Momo rerenga kāore e tautokona: %(clause)s" + +#, python-format +msgid "Unsupported post processing operation: %(operation)s" +msgstr "Mahinga tukatuka-iho kāore e tautokona: %(operation)s" + +#, python-format +msgid "Unsupported return value for method %(name)s" +msgstr "Uara whakahoki kāore e tautokona mō te tikanga %(name)s" + +#, python-format +msgid "Unsupported template value for key %(key)s" +msgstr "Uara tauira kāore e tautokona mō te kī %(key)s" + +#, python-format +msgid "Unsupported time grain: %(time_grain)s" +msgstr "Māeneene wā kāore e tautokona: %(time_grain)s" + +msgid "Untitled Dataset" +msgstr "Rārangi Raraunga Kāore i Taitarahia" + +msgid "Untitled Query" +msgstr "Pātai Kāore i Taitarahia" + +msgid "Untitled query" +msgstr "Pātai kāore i taitarahia" + +msgid "Update" +msgstr "Whakahou" + +msgid "Update chart" +msgstr "Whakahou kauwhata" + +msgid "Updating chart was stopped" +msgstr "I whakamutua te whakahou kauwhata" + +msgid "Upload" +msgstr "Tukuake" + +msgid "Upload CSV" +msgstr "Tukuake CSV" + +msgid "Upload CSV to database" +msgstr "Tukuake CSV ki te pātengi raraunga" + +msgid "Upload Columnar" +msgstr "Tukuake Tīwae Pou" + +msgid "Upload Columnar file to database" +msgstr "Tukuake kōnae Tīwae Pou ki te pātengi raraunga" + +msgid "Upload Enabled" +msgstr "Tukuake Kua Whakahohengia" + +msgid "Upload Excel" +msgstr "Tukuake Excel" + +msgid "Upload Excel to database" +msgstr "Tukuake Excel ki te pātengi raraunga" + +msgid "Upload JSON file" +msgstr "Tukuake kōnae JSON" + +msgid "Upload a file to a database." +msgstr "Tukuake kōnae ki tētahi pātengi raraunga." + +#, python-format +msgid "Upload a file with a valid extension. Valid: [%s]" +msgstr "Tukuake kōnae me te toronga whaimana. Whaimana: [%s]" + +msgid "Upload credentials" +msgstr "Tukuake taipitopito" + +msgid "Upload file to database" +msgstr "Tukuake kōnae ki te pātengi raraunga" + +msgid "Upload file to preview columns" +msgstr "Tukuake kōnae hei arokite i ngā tīwae" + +msgid "Uploading a file is required" +msgstr "E hiahiatia ana te tukuake kōnae" + +msgid "Upper Threshold" +msgstr "Paepae Runga" + +msgid "Upper threshold must be greater than lower threshold" +msgstr "Me rahi ake te paepae runga i te paepae raro" + +msgid "Usage" +msgstr "Whakamahinga" + +#, python-format +msgid "Use \"%(menuName)s\" menu instead." +msgstr "Whakamahia te tahua \"%(menuName)s\" hei utu." + +#, python-format +msgid "Use %s to open in a new tab." +msgstr "Whakamahia %s hei huaki i tētahi ripa hou." + +msgid "Use Area Proportions" +msgstr "Whakamahia Ōwehenga Horahanga" + +msgid "Use a log scale" +msgstr "Whakamahia tauine pūkete" + +msgid "Use a log scale for the X-axis" +msgstr "Whakamahia tauine pūkete mō te tukutuku-X" + +msgid "Use a log scale for the Y-axis" +msgstr "Whakamahia tauine pūkete mō te tukutuku-Y" + +msgid "Use an encrypted connection to the database" +msgstr "Whakamahia hononga whakamunatia ki te pātengi raraunga" + +msgid "Use an ssh tunnel connection to the database" +msgstr "Whakamahia hononga pūaha ssh ki te pātengi raraunga" + +#, python-format +msgid "" +"Use another existing chart as a source for annotations and overlays.\n" +" Your chart must be one of these visualization types: [%s]" +msgstr "" +"Whakamahia tētahi kauwhata kei te tīari hei puna mō ngā tohu me ngā kōpaki." + +msgid "Use current extent" +msgstr "Whakamahia te whānuitanga o nāianei" + +msgid "Use date formatting even when metric value is not a timestamp" +msgstr "Whakamahia hōputu rā ahakoa karekau te uara ine he waitohu" + +msgid "Use metrics as a top level group for columns or for rows" +msgstr "" +"Whakamahia ngā ine hei rōpū taumata runga mō ngā tīwae, mō ngā rārangi rānei" + +msgid "Use only a single value." +msgstr "Whakamahia kotahi uara anake." + +msgid "Use the Advanced Analytics options below" +msgstr "Whakamahia ngā kōwhiringa Tātaritanga Aromatawai i raro nei" + +msgid "Use the edit button to change this field" +msgstr "Whakamahia te pātene whakatika hei huri i tēnei āpure" + +msgid "Use this section if you want a query that aggregates" +msgstr "" +"Whakamahia tēnei wāhanga mēnā e hiahia ana koe i tētahi pātai ka whakaarotau" + +msgid "Use this section if you want to query atomic rows" +msgstr "" +"Whakamahia tēnei wāhanga mēnā e hiahia ana koe ki te pātai i ngā rārangi ira" + +msgid "Use this to define a static color for all circles" +msgstr "Whakamahia tēnei hei tautuhi i tētahi tae mau mō ngā porohita katoa" + +msgid "" +"Used internally to identify the plugin. Should be set to the package name " +"from the pluginʼs package.json" +msgstr "" +"Ka whakamahia i roto hei tautuhi i te mono. Me tautuhi ki te ingoa kete mai " +"i te package.json o te mono" + +msgid "" +"Used to summarize a set of data by grouping together multiple statistics " +"along two axes. Examples: Sales numbers by region and month, tasks by status" +" and assignee, active users by age and location. Not the most visually " +"stunning visualization, but highly informative and versatile." +msgstr "" +"Ka whakamahia hei whakarāpopoto i tētahi huinga raraunga mā te rōpū tahi i " +"ngā tauanga maha i ngā tukutuku e rua. Tauira: Tau hokohoko mā te rohe me te" +" marama, mahi mā te tūnga me te kaitūtohu, kaiwhakamahi hohe mā te pakeke me" +" te wāhi. Ehara i te whakakitenga ātaahua rawa, engari he nui te mōhiohio, " +"he maha ngā tikanga." + +msgid "User" +msgstr "Kaiwhakamahi" + +msgid "User doesn't have the proper permissions." +msgstr "Karekau ō mōtika tika a te kaiwhakamahi." + +msgid "User must select a value before applying the filter" +msgstr "" +"Me tīpako te kaiwhakamahi i tētahi uara i mua i te whakahaeretia o te tātari" + +msgid "User query" +msgstr "Pātai kaiwhakamahi" + +msgid "User was successfully created!" +msgstr "I angitu te hanganga o te kaiwhakamahi!" + +msgid "User was successfully updated!" +msgstr "I angitu te whakahouhanga o te kaiwhakamahi!" + +msgid "Username" +msgstr "Ingoa kaiwhakamahi" + +msgid "Username is required" +msgstr "E hiahiatia ana te ingoa kaiwhakamahi" + +msgid "Users" +msgstr "Kaiwhakamahi" + +msgid "Users are not allowed to set a search path for security reasons." +msgstr "" +"Kāore e whakāetia ngā kaiwhakamahi ki te tautuhi i tētahi ara rapu mō ngā " +"take haumaru." + +msgid "" +"Uses Gaussian Kernel Density Estimation to visualize spatial distribution of" +" data" +msgstr "" +"Ka whakamahi i te Tauwhitinga Mātotoru Pūkaha Gaussian hei whakakite i te " +"tohatoha tauwāhi o ngā raraunga" + +msgid "" +"Uses a gauge to showcase progress of a metric towards a target. The position" +" of the dial represents the progress and the terminal value in the gauge " +"represents the target value." +msgstr "" +"Ka whakamahi i tētahi ine hei whakaatu i te kokenga o tētahi ine ki tētahi " +"whāinga. Ko te tūnga o te waea e tohu ana i te kokenga, ā, ko te uara " +"whakamutunga i te ine e tohu ana i te uara whāinga." + +msgid "" +"Uses circles to visualize the flow of data through different stages of a " +"system. Hover over individual paths in the visualization to understand the " +"stages a value took. Useful for multi-stage, multi-group visualizing funnels" +" and pipelines." +msgstr "" +"Ka whakamahi i ngā porohita hei whakakite i te rere o ngā raraunga i ngā " +"wāhanga rerekē o tētahi pūnaha. Haewē i runga i ngā ara takitahi i te " +"whakakitenga hei mārama i ngā wāhanga i mau i tētahi uara. He whaihua mō te " +"whakakite i ngā kōrere me ngā paipa wāhanga-maha, rōpū-maha." + +#, python-format +msgid "Validating connectivity for %s" +msgstr "E manatoko ana i te hononga mō %s" + +msgid "Value" +msgstr "Uara" + +msgid "Value Domain" +msgstr "Rohe Uara" + +msgid "Value Format" +msgstr "Hōputu Uara" + +msgid "Value and Percentage" +msgstr "Uara me te Ōrau" + +msgid "Value bounds" +msgstr "Rohe uara" + +#, python-format +msgid "Value cannot exceed %s" +msgstr "Kāore e taea e te uara te nui ake i %s" + +msgid "Value difference between the time periods" +msgstr "Rerekētanga uara i waenga i ngā wā" + +msgid "Value format" +msgstr "Hōputu uara" + +msgid "Value greater than" +msgstr "Uara nui ake i" + +msgid "Value is required" +msgstr "E hiahiatia ana te uara" + +msgid "Value less than" +msgstr "Uara iti ake i" + +msgid "Value must be 0 or greater" +msgstr "Me noho te uara hei 0, nui ake rānei" + +msgid "Value must be greater than 0" +msgstr "Me nui ake te uara i te 0" + +msgid "Values are dependent on other filters" +msgstr "E whakawhirinaki ana ngā uara ki ētahi atu tātari" + +msgid "Values dependent on" +msgstr "Uara e whakawhirinaki ana ki" + +msgid "" +"Values selected in other filters will affect the filter options to only show" +" relevant values" +msgstr "" +"Ka pā ngā uara kua tīpakohia i ētahi atu tātari ki ngā kōwhiringa tātari hei" +" whakaatu anake i ngā uara hāngai" + +msgid "Version" +msgstr "Putanga" + +msgid "Version number" +msgstr "Tau putanga" + +msgid "Vertical" +msgstr "Poutū" + +msgid "Vertical (Left)" +msgstr "Poutū (Mauī)" + +msgid "View" +msgstr "Tirohanga" + +msgid "View All »" +msgstr "Tirohia Katoa »" + +msgid "View Dataset" +msgstr "Tirohia Rārangi Raraunga" + +msgid "View all charts" +msgstr "Tirohia ngā kauwhata katoa" + +msgid "View as table" +msgstr "Tirohia hei ripanga" + +msgid "View in SQL Lab" +msgstr "Tirohia i SQL Lab" + +#, python-format +msgid "View keys & indexes (%s)" +msgstr "Tirohia ngā kī me ngā kuputohu (%s)" + +msgid "View query" +msgstr "Tirohia pātai" + +msgid "Viewed" +msgstr "Kua Tirohia" + +#, python-format +msgid "Viewed %s" +msgstr "Kua Tirohia %s" + +msgid "Viewport" +msgstr "Tirohanga" + +msgid "Virtual" +msgstr "Mariko" + +msgid "Virtual (SQL)" +msgstr "Mariko (SQL)" + +msgid "Virtual dataset query cannot be empty" +msgstr "Kāore e taea te noho kau te pātai rārangi raraunga mariko" + +msgid "Virtual dataset query cannot consist of multiple statements" +msgstr "" +"Kāore e taea e te pātai rārangi raraunga mariko te noho hei kīanga maha" + +msgid "Virtual dataset query must be read-only" +msgstr "Me pānui-anake te pātai rārangi raraunga mariko" + +msgid "Visual Tweaks" +msgstr "Tāmata Tirohanga" + +msgid "Visual formatting" +msgstr "Hōputu tirohanga" + +msgid "Visualization Type" +msgstr "Momo Whakakitenga" + +msgid "" +"Visualize a parallel set of metrics across multiple groups. Each group is " +"visualized using its own line of points and each metric is represented as an" +" edge in the chart." +msgstr "" +"Whakakite i tētahi huinga ōrite o ngā ine puta noa i ngā rōpū maha. Ko ia " +"rōpū e whakaaturia ana mā tōna ake rārangi tohu, ā, ko ia ine e tohua ana " +"hei tapa i te kauwhata." + +msgid "" +"Visualize a related metric across pairs of groups. Heatmaps excel at " +"showcasing the correlation or strength between two groups. Color is used to " +"emphasize the strength of the link between each pair of groups." +msgstr "" +"Whakakite i tētahi ine hāngai puta noa i ngā takirua o ngā rōpū. He pai rawa" +" te Mahere Wera ki te whakaatu i te hononga, i te kaha rānei i waenga i ngā " +"rōpū e rua. Ka whakamahia te tae hei whakatoi i te kaha o te hononga i " +"waenga i ia takirua o ngā rōpū." + +msgid "" +"Visualize geospatial data like 3D buildings, landscapes, or objects in grid " +"view." +msgstr "" +"Whakakite i ngā raraunga tauwāhi pērā i ngā whare 3D, ngā oneone whenua, ngā" +" ahanoa rānei i te tirohanga tukutata." + +msgid "" +"Visualize multiple levels of hierarchy using a familiar tree-like structure." +msgstr "" +"Whakakite i ngā taumata taumata maha mā te whakamahi i tētahi hangahanga " +"pērā i te rākau." + +msgid "" +"Visualize two different series using the same x-axis. Note that both series " +"can be visualized with a different chart type (e.g. 1 using bars and 1 using" +" a line)." +msgstr "" +"Whakakite i ngā raupapa rerekē e rua mā te whakamahi i te tukutuku-x ōrite. " +"Kia mōhio ka taea e ngā raupapa e rua te whakaatu ki tētahi momo kauwhata " +"rerekē (hei tauira 1 mā te pae, 1 mā te rārangi)." + +msgid "" +"Visualizes a metric across three dimensions of data in a single chart (X " +"axis, Y axis, and bubble size). Bubbles from the same group can be showcased" +" using bubble color." +msgstr "" +"Ka whakaatu i tētahi ine puta noa i ngā āhuahanga e toru o ngā raraunga i " +"tētahi kauwhata kotahi (tukutuku X, tukutuku Y, me te rahi pōro). Ka taea " +"ngā pōro mai i te rōpū ōrite te whakaatu mā te tae pōro." + +msgid "Visualizes connected points, which form a path, on a map." +msgstr "" +"Ka whakaatu i ngā tohu kua honoa, ka hanga i tētahi ara, i runga i tētahi " +"mahere." + +msgid "" +"Visualizes geographic areas from your data as polygons on a Mapbox rendered " +"map. Polygons can be colored using a metric." +msgstr "" +"Ka whakaatu i ngā horahanga takiwā mai i ō raraunga hei tapawhā i runga i " +"tētahi mahere Mapbox kua whakaaturia. Ka taea te tae i ngā tapawhā mā tētahi" +" ine." + +msgid "" +"Visualizes how a metric has changed over a time using a color scale and a " +"calendar view. Gray values are used to indicate missing values and the " +"linear color scheme is used to encode the magnitude of each day's value." +msgstr "" +"Ka whakaatu i te panoni o tētahi ine i te wā mā te whakamahi i tētahi tauine" +" tae me tētahi tirohanga maramataka. Ka whakamahia ngā uara hina hei tohu i " +"ngā uara ngaro, ā, ka whakamahia te kaupapa tae rārangi hei whakakohu i te " +"rahi o te uara o ia rā." + +msgid "" +"Visualizes how a single metric varies across a country's principal " +"subdivisions (states, provinces, etc) on a choropleth map. Each " +"subdivision's value is elevated when you hover over the corresponding " +"geographic boundary." +msgstr "" +"Ka whakaatu i te panoni o tētahi ine kotahi puta noa i ngā wāhanga matua o " +"tētahi whenua (tāone, kawanatanga, me ērā atu) i runga i tētahi mahere " +"choropleth. Ka whakateiteia te uara o ia wāhanga ina haewē koe i runga i te " +"rohe takiwā hāngai." + +msgid "" +"Visualizes many different time-series objects in a single chart. This chart " +"is being deprecated and we recommend using the Time-series Chart instead." +msgstr "" +"Ka whakaatu i ngā ahanoa raupapa-wā rerekē maha i tētahi kauwhata kotahi. " +"Kei te whakakorehia tēnei kauwhata, ā, e tūtohu ana mātou ki te whakamahi i " +"te Kauwhata Raupapa-wā hei utu." + +msgid "" +"Visualizes the words in a column that appear the most often. Bigger font " +"corresponds to higher frequency." +msgstr "" +"Ka whakaatu i ngā kupu i tētahi tīwae e puta nui ana. Ko te momotuhi nui e " +"hāngai ana ki te auau teitei." + +msgid "Viz is missing a datasource" +msgstr "Kei te ngaro tētahi puna raraunga i te Viz" + +msgid "Viz type" +msgstr "Momo viz" + +msgid "WED" +msgstr "WEN" + +msgid "WFS" +msgstr "WFS" + +msgid "WMS" +msgstr "WMS" + +#, python-format +msgid "Waiting on %s" +msgstr "E tatari ana i %s" + +msgid "Waiting on database..." +msgstr "E tatari ana i te pātengi raraunga..." + +msgid "Want to add a new database?" +msgstr "Kei te hiahia koe ki te tāpiri i tētahi pātengi raraunga hou?" + +msgid "Warning" +msgstr "Whakatūpato" + +msgid "Warning!" +msgstr "Whakatūpato!" + +msgid "" +"Warning! Changing the dataset may break the chart if the metadata does not " +"exist." +msgstr "" +"Whakatūpato! Mā te huri i te rārangi raraunga ka taea pea te wāhi i te " +"kauwhata mēnā karekau te metadata." + +msgid "Was unable to check your query" +msgstr "Kāore i taea te tirotiro i tō pātai" + +msgid "Waterfall Chart" +msgstr "Kauwhata Rere Wai" + +msgid "" +"We are unable to connect to your database. Click \"See more\" for database-" +"provided information that may help troubleshoot the issue." +msgstr "" +"Kāore e taea e mātou te hono ki tō pātengi raraunga. Pāwhiria \"Tirohia " +"atu\" mō ngā mōhiohio pātengi raraunga ka taea pea te āwhina i te whakatika " +"i te raru." + +#, python-format +msgid "We can't seem to resolve column \"%(column)s\" at line %(location)s." +msgstr "" +"Kāore e taea e mātou te whakaoti i te tīwae \"%(column)s\" i te rārangi " +"%(location)s." + +#, python-format +msgid "We can't seem to resolve the column \"%(column_name)s\"" +msgstr "Kāore e taea e mātou te whakaoti i te tīwae \"%(column_name)s\"" + +#, python-format +msgid "" +"We can't seem to resolve the column \"%(column_name)s\" at line " +"%(location)s." +msgstr "" +"Kāore e taea e mātou te whakaoti i te tīwae \"%(column_name)s\" i te rārangi" +" %(location)s." + +#, python-format +msgid "We have the following keys: %s" +msgstr "Kei a mātou ēnei kī: %s" + +msgid "We were unable to active or deactivate this report." +msgstr "" +"Kāore i taea e mātou te whakahohe, te whakakore rānei i tēnei pūrongo." + +msgid "" +"We were unable to carry over any controls when switching to this new " +"dataset." +msgstr "" +"Kāore i taea e mātou te whai i ngā whakahaere i te huringa ki tēnei rārangi " +"raraunga hou." + +#, python-format +msgid "" +"We were unable to connect to your database named \"%(database)s\". Please " +"verify your database name and try again." +msgstr "" +"Kāore i taea e mātou te hono ki tō pātengi raraunga ko \"%(database)s\" te " +"ingoa. Tēnā manatokohia tō ingoa pātengi raraunga, ā, whakamātauhia anō." + +msgid "Web" +msgstr "Tukutuku" + +msgid "Wednesday" +msgstr "Wenerei" + +msgid "Week" +msgstr "Wiki" + +msgid "Week ending Saturday" +msgstr "Wiki ka mutu i te Hātarei" + +msgid "Week ending Sunday" +msgstr "Wiki ka mutu i te Rātapu" + +msgid "Week starting Monday" +msgstr "Wiki ka tīmata i te Mane" + +msgid "Week starting Sunday" +msgstr "Wiki ka tīmata i te Rātapu" + +msgid "Weekly Report" +msgstr "Pūrongo Ia Wiki" + +#, python-format +msgid "Weekly Report for %s" +msgstr "Pūrongo Ia Wiki mō %s" + +msgid "Weekly seasonality" +msgstr "Wātanga wā ia wiki" + +#, python-format +msgid "Weeks %s" +msgstr "Wiki %s" + +msgid "Weight" +msgstr "Taumaha" + +#, python-format +msgid "" +"We’re having trouble loading these results. Queries are set to timeout after" +" %s second." +msgid_plural "" +"We’re having trouble loading these results. Queries are set to timeout after" +" %s seconds." +msgstr[0] "" +"Kei te uaua te uta i ēnei hua. Kua tautuhia ngā pātai ki te wā-pau i muri i " +"%s hēkona." +msgstr[1] "" +"Kei te uaua te uta i ēnei hua. Kua tautuhia ngā pātai ki te wā-pau i muri i " +"%s hēkona." + +#, python-format +msgid "" +"We’re having trouble loading this visualization. Queries are set to timeout " +"after %s second." +msgid_plural "" +"We’re having trouble loading this visualization. Queries are set to timeout " +"after %s seconds." +msgstr[0] "" +"Kei te uaua te uta i tēnei whakakitenga. Kua tautuhia ngā pātai ki te wā-pau" +" i muri i %s hēkona." +msgstr[1] "" +"Kei te uaua te uta i tēnei whakakitenga. Kua tautuhia ngā pātai ki te wā-pau" +" i muri i %s hēkona." + +msgid "What should be shown as the label" +msgstr "Me whakaaturia hei tapanga" + +msgid "What should be shown as the tooltip label" +msgstr "Me whakaaturia hei tapanga kītukutuku" + +msgid "What should be shown on the label?" +msgstr "Me whakaaturia i te tapanga?" + +msgid "What should happen if the table already exists" +msgstr "Me aha mēnā kei te tīari kē te ripanga" + +msgid "" +"When `Calculation type` is set to \"Percentage change\", the Y Axis Format " +"is forced to `.1%`" +msgstr "" +"Ina tautuhia te `Momo tatauranga` ki te \"Panoni ōrau\", ka akina te Hōputu " +"Tukutuku Y ki te `.1%`" + +msgid "When a secondary metric is provided, a linear color scale is used." +msgstr "" +"Ina tukuna tētahi ine tuarua, ka whakamahia tētahi tauine tae rārangi." + +msgid "When checked, the map will zoom to your data after each query" +msgstr "Ina pātia, ka topa te mahere ki ō raraunga i muri i ia pātai" + +msgid "When enabled, users are able to visualize SQL Lab results in Explore." +msgstr "" +"Ina whakahohengia, ka taea e ngā kaiwhakamahi te whakakite i ngā hua SQL Lab" +" i te Tūhura." + +msgid "" +"When only a primary metric is provided, a categorical color scale is used." +msgstr "Ina tukuna he ine matua anake, ka whakamahia tētahi tauine tae kāwai." + +msgid "" +"When specifying SQL, the datasource acts as a view. Superset will use this " +"statement as a subquery while grouping and filtering on the generated parent" +" queries." +msgstr "" +"Ina tohua te SQL, ka mahi te puna raraunga hei tirohanga. Ka whakamahi a " +"Superset i tēnei kīanga hei pātai-iti i te wā e rōpū ana, e tātari ana i ngā" +" pātai mātua i hangaia." + +msgid "" +"When the secondary temporal columns are filtered, apply the same filter to " +"the main datetime column." +msgstr "" +"Ina tātaritia ngā tīwae wā tuarua, whakahaeretia te tātari ōrite ki te tīwae" +" wā matua." + +msgid "" +"When unchecked, colors from the selected color scheme will be used for time " +"shifted series" +msgstr "" +"Ina kāore i pātia, ka whakamahia ngā tae mai i te kaupapa tae kua tīpakohia " +"mō ngā raupapa kua nekehia te wā" + +msgid "" +"When using \"Autocomplete filters\", this can be used to improve performance" +" of the query fetching the values. Use this option to apply a predicate " +"(WHERE clause) to the query selecting the distinct values from the table. " +"Typically the intent would be to limit the scan by applying a relative time " +"filter on a partitioned or indexed time-related field." +msgstr "" +"Ina whakamahi i ngā \"Tātari whakaoti aunoa\", ka taea te whakamahi i tēnei " +"hei whakapai ake i te whakatutukitanga o te pātai e tiki ana i ngā uara. " +"Whakamahia tēnei kōwhiringa hei whakahaeretia i tētahi kīanga tohu (rerenga " +"WHERE) ki te pātai e tīpako ana i ngā uara motuhake mai i te ripanga. Ko te " +"tikanga noa ko te whakawhāiti i te hōpara mā te whakahaeretia i tētahi " +"tātari wā tata i runga i tētahi āpure wā kua wāhangahia, kua kupuhia rānei." + +msgid "When using 'Group By' you are limited to use a single metric" +msgstr "" +"Ina whakamahi i te 'Rōpū Mā' ka whakawhāititia koe ki te whakamahi i tētahi " +"ine kotahi" + +msgid "When using other than adaptive formatting, labels may overlap" +msgstr "" +"Ina whakamahi i ētahi atu haunga te hōputu urutau, ka taea pea e ngā tapanga" +" te whārua" + +msgid "" +"When using this option, default value can’t be set. Using this option may " +"impact the load times for your dashboard." +msgstr "" +"Ina whakamahi i tēnei kōwhiringa, kāore e taea te tautuhi i te uara taunoa. " +"Mā te whakamahi i tēnei kōwhiringa ka pā pea ki ngā wā uta mō tō papatohu." + +msgid "" +"Whether the progress bar overlaps when there are multiple groups of data" +msgstr "Mēnā ka whārua te pae kokenga ina he maha ngā rōpū raraunga" + +msgid "" +"Whether to align background charts with both positive and negative values at" +" 0" +msgstr "" +"Mēnā ka whakarite i ngā kauwhata papamuri me ngā uara pai me ngā uara kino i" +" te 0" + +msgid "Whether to align positive and negative values in cell bar chart at 0" +msgstr "" +"Mēnā ka whakarite i ngā uara pai me ngā uara kino i te kauwhata pae pūtau i " +"te 0" + +msgid "Whether to always show the annotation label" +msgstr "Mēnā ka whakaatu i te tapanga tohu i ngā wā katoa" + +msgid "Whether to animate the progress and the value or just display them" +msgstr "Mēnā ka whakahihiko i te kokenga me te uara, ka whakaatu noa rānei" + +msgid "" +"Whether to apply a normal distribution based on rank on the color scale" +msgstr "" +"Mēnā ka whakahaeretia tētahi tohatoha noa i runga i te kōmaka i te tauine " +"tae" + +msgid "Whether to apply filter when items are clicked" +msgstr "Mēnā ka whakahaeretia te tātari ina pāwhiria ngā mea" + +msgid "Whether to colorize numeric values by if they are positive or negative" +msgstr "Mēnā ka tae i ngā uara tau mēnā he pai, he kino rānei" + +msgid "" +"Whether to colorize numeric values by whether they are positive or negative" +msgstr "Mēnā ka tae i ngā uara tau mēnā he pai, he kino rānei" + +msgid "Whether to display a bar chart background in table columns" +msgstr "Mēnā ka whakaatu i te papamuri kauwhata pae i ngā tīwae ripanga" + +msgid "Whether to display a legend for the chart" +msgstr "Mēnā ka whakaatu i tētahi kōrero mō te kauwhata" + +msgid "Whether to display bubbles on top of countries" +msgstr "Mēnā ka whakaatu i ngā pōro i runga i ngā whenua" + +msgid "Whether to display in the chart" +msgstr "Mēnā ka whakaatu i te kauwhata" + +msgid "Whether to display the aggregate count" +msgstr "Mēnā ka whakaatu i te tatau whakaarotau" + +msgid "Whether to display the interactive data table" +msgstr "Mēnā ka whakaatu i te ripanga raraunga taunekeneke" + +msgid "Whether to display the labels." +msgstr "Mēnā ka whakaatu i ngā tapanga." + +msgid "Whether to display the legend (toggles)" +msgstr "Mēnā ka whakaatu i te kōrero (pātene)" + +msgid "Whether to display the metric name as a title" +msgstr "Mēnā ka whakaatu i te ingoa ine hei taitara" + +msgid "Whether to display the min and max values of the X-axis" +msgstr "Mēnā ka whakaatu i ngā uara iti me ngā uara rahi o te tukutuku-X" + +msgid "Whether to display the min and max values of the Y-axis" +msgstr "Mēnā ka whakaatu i ngā uara iti me ngā uara rahi o te tukutuku-Y" + +msgid "Whether to display the numerical values within the cells" +msgstr "Mēnā ka whakaatu i ngā uara tau i roto i ngā pūtau" + +msgid "Whether to display the percentage value in the tooltip" +msgstr "Mēnā ka whakaatu i te uara ōrau i te kītukutuku" + +msgid "Whether to display the stroke" +msgstr "Mēnā ka whakaatu i te whakapā" + +msgid "Whether to display the time range interactive selector" +msgstr "Mēnā ka whakaatu i te kaitīpako taunekeneke awhe wā" + +msgid "Whether to display the timestamp" +msgstr "Mēnā ka whakaatu i te waitohu" + +msgid "Whether to display the tooltip labels." +msgstr "Mēnā ka whakaatu i ngā tapanga kītukutuku." + +msgid "Whether to display the total value in the tooltip" +msgstr "Mēnā ka whakaatu i te uara tapeke i te kītukutuku" + +msgid "Whether to display the trend line" +msgstr "Mēnā ka whakaatu i te rārangi ia" + +msgid "Whether to display the type icon (#, Δ, %)" +msgstr "Mēnā ka whakaatu i te tohu momo (#, Δ, %)" + +msgid "Whether to enable changing graph position and scaling." +msgstr "Mēnā ka whakahohe i te huri i te tūnga kauwhata me te tauine." + +msgid "Whether to enable node dragging in force layout mode." +msgstr "Mēnā ka whakahohe i te tō pona i te aratau takotoranga kaha." + +msgid "Whether to fill the objects" +msgstr "Mēnā ka whakakī i ngā ahanoa" + +msgid "Whether to ignore locations that are null" +msgstr "Mēnā ka whakakorehia i ngā wāhi he kore" + +msgid "Whether to include a client-side search box" +msgstr "Mēnā ka whakauru i tētahi pouaka rapu taha-kiritaki" + +msgid "Whether to include the percentage in the tooltip" +msgstr "Mēnā ka whakauru i te ōrau i te kītukutuku" + +msgid "Whether to include the time granularity as defined in the time section" +msgstr "Mēnā ka whakauru i te māeneene wā e tautuhia ana i te wāhanga wā" + +msgid "Whether to make the grid 3D" +msgstr "Mēnā ka hanga i te tukutata 3D" + +msgid "Whether to populate autocomplete filters options" +msgstr "Mēnā ka whakakī i ngā kōwhiringa tātari whakaoti aunoa" + +msgid "Whether to show as Nightingale chart." +msgstr "Mēnā ka whakaatu hei kauwhata Nightingale." + +msgid "" +"Whether to show extra controls or not. Extra controls include things like " +"making multiBar charts stacked or side by side." +msgstr "" +"Mēnā ka whakaatu i ngā whakahaere taapiri. Ko ngā whakahaere taapiri ko ngā " +"mea pērā i te hanga i ngā kauwhata multiBar kia paparanga, kia taha-taha " +"rānei." + +msgid "Whether to show minor ticks on the axis" +msgstr "Mēnā ka whakaatu i ngā tika iti i te tukutuku" + +msgid "Whether to show the pointer" +msgstr "Mēnā ka whakaatu i te tohu" + +msgid "Whether to show the progress of gauge chart" +msgstr "Mēnā ka whakaatu i te kokenga o te kauwhata ine" + +msgid "Whether to show the split lines on the axis" +msgstr "Mēnā ka whakaatu i ngā rārangi wehe i te tukutuku" + +msgid "Whether to sort ascending or descending on the base Axis." +msgstr "Mēnā ka kōmaka piki, heke rānei i te Tukutuku pūtake." + +msgid "Whether to sort descending or ascending" +msgstr "Mēnā ka kōmaka heke, piki rānei" + +msgid "Whether to sort results by the selected metric in descending order." +msgstr "Mēnā ka kōmaka i ngā hua mā te ine kua tīpakohia i te raupapa heke." + +msgid "Whether to sort tooltip by the selected metric in descending order." +msgstr "" +"Mēnā ka kōmaka i te kītukutuku mā te ine kua tīpakohia i te raupapa heke." + +msgid "Whether to truncate metrics" +msgstr "Mēnā ka porohita i ngā ine" + +msgid "Which country to plot the map for?" +msgstr "Ko tēhea whenua hei whakatakoto mahere?" + +msgid "Which relatives to highlight on hover" +msgstr "Ko ēhea ngā whanaunga hei whakamiramira i te haewē" + +msgid "Whisker/outlier options" +msgstr "Kōwhiringa whīhau/wāhitauwehe" + +msgid "White" +msgstr "Mā" + +msgid "Width" +msgstr "Whānui" + +msgid "Width of the confidence interval. Should be between 0 and 1" +msgstr "Whānui o te wā pono. Me noho i waenga i te 0 me te 1" + +msgid "Width of the sparkline" +msgstr "Whānui o te rārangi kōhā" + +msgid "Window must be > 0" +msgstr "Me > 0 te matapihi" + +msgid "With a subheader" +msgstr "Me te pane-iti" + +msgid "Word Cloud" +msgstr "Kapua Kupu" + +msgid "Word Rotation" +msgstr "Hurihuri Kupu" + +msgid "Working" +msgstr "E Mahi Ana" + +msgid "Working timeout" +msgstr "Wā-pau mahi" + +msgid "World Map" +msgstr "Mahere Ao" + +msgid "Write a description for your query" +msgstr "Tuhia he whakamārama mō tō pātai" + +msgid "Write a handlebars template to render the data" +msgstr "Tuhia he tauira handlebars hei whakaatu i ngā raraunga" + +msgid "X axis title margin" +msgstr "Taiapa taitara tukutuku x" + +msgid "X Axis" +msgstr "Tukutuku X" + +msgid "X Axis Bounds" +msgstr "Rohe Tukutuku X" + +msgid "X Axis Format" +msgstr "Hōputu Tukutuku X" + +msgid "X Axis Label" +msgstr "Tapanga Tukutuku X" + +msgid "X Axis Title" +msgstr "Taitara Tukutuku X" + +msgid "X Axis Title Margin" +msgstr "Taiapa Taitara Tukutuku X" + +msgid "X Log Scale" +msgstr "Tauine Pūkete X" + +msgid "X Tick Layout" +msgstr "Hoahoa Tika X" + +msgid "X bounds" +msgstr "Rohe X" + +msgid "X-Axis Sort Ascending" +msgstr "Kōmaka Tukutuku-X Piki" + +msgid "X-Axis Sort By" +msgstr "Kōmaka Tukutuku-X Mā" + +msgid "X-axis" +msgstr "Tukutuku-x" + +msgid "X-scale interval" +msgstr "Wā tauine-X" + +msgid "XYZ" +msgstr "XYZ" + +msgid "Y 2 bounds" +msgstr "Rohe Y 2" + +msgid "Y axis title margin" +msgstr "Taiapa taitara tukutuku y" + +msgid "Y Axis" +msgstr "Tukutuku Y" + +msgid "Y Axis 2 Bounds" +msgstr "Rohe Tukutuku Y 2" + +msgid "Y Axis Bounds" +msgstr "Rohe Tukutuku Y" + +msgid "Y Axis Format" +msgstr "Hōputu Tukutuku Y" + +msgid "Y Axis Label" +msgstr "Tapanga Tukutuku Y" + +msgid "Y Axis Title" +msgstr "Taitara Tukutuku Y" + +msgid "Y Axis Title Margin" +msgstr "Taiapa Taitara Tukutuku Y" + +msgid "Y Axis Title Position" +msgstr "Tūnga Taitara Tukutuku Y" + +msgid "Y Log Scale" +msgstr "Tauine Pūkete Y" + +msgid "Y bounds" +msgstr "Rohe Y" + +msgid "Y-Axis" +msgstr "Tukutuku-Y" + +msgid "Y-Axis Sort Ascending" +msgstr "Kōmaka Tukutuku-Y Piki" + +msgid "Y-Axis Sort By" +msgstr "Kōmaka Tukutuku-Y Mā" + +msgid "Y-axis" +msgstr "Tukutuku-y" + +msgid "Y-axis bounds" +msgstr "Rohe tukutuku-y" + +msgid "Y-scale interval" +msgstr "Wā tauine-Y" + +msgid "Year" +msgstr "Tau" + +msgid "Year (freq=AS)" +msgstr "Tau (freq=AS)" + +msgid "Yearly seasonality" +msgstr "Wātanga wā ia tau" + +#, python-format +msgid "Years %s" +msgstr "Tau %s" + +msgid "Yes" +msgstr "Āe" + +msgid "Yes, cancel" +msgstr "Āe, whakakore" + +msgid "Yes, overwrite changes" +msgstr "Āe, tuhirua huringa" + +#, python-format +msgid "You are adding tags to %s %ss" +msgstr "E tāpiri ana koe i ngā tohu ki %s %ss" + +msgid "" +"You are importing one or more charts that already exist. Overwriting might " +"cause you to lose some of your work. Are you sure you want to overwrite?" +msgstr "" +"E kawemai ana koe i tētahi, nui ake rānei kauwhata kua tīari. Mā te tuhirua " +"ka ngaro pea ētahi o ō mahi. Kei te tino hiahia koe ki te tuhirua?" + +msgid "" +"You are importing one or more dashboards that already exist. Overwriting " +"might cause you to lose some of your work. Are you sure you want to " +"overwrite?" +msgstr "" +"E kawemai ana koe i tētahi, nui ake rānei papatohu kua tīari. Mā te tuhirua " +"ka ngaro pea ētahi o ō mahi. Kei te tino hiahia koe ki te tuhirua?" + +msgid "" +"You are importing one or more databases that already exist. Overwriting " +"might cause you to lose some of your work. Are you sure you want to " +"overwrite?" +msgstr "" +"E kawemai ana koe i tētahi, nui ake rānei pātengi raraunga kua tīari. Mā te " +"tuhirua ka ngaro pea ētahi o ō mahi. Kei te tino hiahia koe ki te tuhirua?" + +msgid "" +"You are importing one or more datasets that already exist. Overwriting might" +" cause you to lose some of your work. Are you sure you want to overwrite?" +msgstr "" +"E kawemai ana koe i tētahi, nui ake rānei rārangi raraunga kua tīari. Mā te " +"tuhirua ka ngaro pea ētahi o ō mahi. Kei te tino hiahia koe ki te tuhirua?" + +msgid "" +"You are importing one or more saved queries that already exist. Overwriting " +"might cause you to lose some of your work. Are you sure you want to " +"overwrite?" +msgstr "" +"E kawemai ana koe i tētahi, nui ake rānei pātai kua tiakina kua tīari. Mā te" +" tuhirua ka ngaro pea ētahi o ō mahi. Kei te tino hiahia koe ki te tuhirua?" + +msgid "" +"You are viewing this chart in a dashboard context with labels shared across multiple charts.\n" +" The color scheme selection is disabled." +msgstr "" +"E tirohia ana e koe tēnei kauwhata i roto i tētahi horopaki papatohu me ngā " +"tapanga e tuaritia ana puta noa i ngā kauwhata maha." + +msgid "" +"You are viewing this chart in the context of a dashboard that is directly affecting its colors.\n" +" To edit the color scheme, open this chart outside of the dashboard." +msgstr "" +"E tirohia ana e koe tēnei kauwhata i roto i te horopaki o tētahi papatohu e " +"pā tōtika ana ki ōna tae." + +msgid "You can" +msgstr "Ka taea e koe" + +msgid "You can add the components in the" +msgstr "Ka taea e koe te tāpiri i ngā waeine i te" + +msgid "You can add the components in the edit mode." +msgstr "Ka taea e koe te tāpiri i ngā waeine i te aratau whakatika." + +msgid "You can also just click on the chart to apply cross-filter." +msgstr "" +"Ka taea hoki e koe te pāwhiri noa i te kauwhata hei whakahaeretia i te " +"tātari-whiti." + +msgid "" +"You can choose to display all charts that you have access to or only the ones you own.\n" +" Your filter selection will be saved and remain active until you choose to change it." +msgstr "" +"Ka taea e koe te kōwhiri ki te whakaatu i ngā kauwhata katoa kei a koe te " +"urunga, i ngā mea nōu anake rānei." + +msgid "" +"You can create a new chart or use existing ones from the panel on the right" +msgstr "" +"Ka taea e koe te hanga i tētahi kauwhata hou, te whakamahi rānei i ērā kua " +"tīari mai i te papa i te taha matau" + +msgid "You can preview the list of dashboards in the chart settings dropdown." +msgstr "" +"Ka taea e koe te arokite i te rārangi papatohu i te taka iho tautuhinga " +"kauwhata." + +msgid "You can't apply cross-filter on this data point." +msgstr "" +"Kāore e taea e koe te whakahaeretia i te tātari-whiti i tēnei tohu raraunga." + +msgid "" +"You cannot delete the last temporal filter as it's used for time range " +"filters in dashboards." +msgstr "" +"Kāore e taea e koe te muku i te tātari wā whakamutunga nō te mea e " +"whakamahia ana mō ngā tātari awhe wā i ngā papatohu." + +msgid "You cannot use 45° tick layout along with the time range filter" +msgstr "" +"Kāore e taea e koe te whakamahi i te hoahoa tika 45° tahi me te tātari awhe " +"wā" + +#, python-format +msgid "You do not have permission to edit this %s" +msgstr "Karekau ō mōtika ki te whakatika i tēnei %s" + +msgid "You do not have permission to edit this chart" +msgstr "Karekau ō mōtika ki te whakatika i tēnei kauwhata" + +msgid "You do not have permission to edit this dashboard" +msgstr "Karekau ō mōtika ki te whakatika i tēnei papatohu" + +msgid "You do not have permission to read tags" +msgstr "Karekau ō mōtika ki te pānui i ngā tohu" + +msgid "You do not have permissions to edit this dashboard." +msgstr "Karekau ō mōtika ki te whakatika i tēnei papatohu." + +msgid "You do not have sufficient permissions to edit the chart" +msgstr "Karekau ō mōtika nui rawa ki te whakatika i te kauwhata" + +msgid "You don't have access to this chart." +msgstr "Karekau ō urunga ki tēnei kauwhata." + +msgid "You don't have access to this dashboard." +msgstr "Karekau ō urunga ki tēnei papatohu." + +msgid "You don't have access to this dataset." +msgstr "Karekau ō urunga ki tēnei rārangi raraunga." + +msgid "You don't have access to this embedded dashboard config." +msgstr "Karekau ō urunga ki tēnei whirihora papatohu tāmau." + +msgid "You don't have permission to modify the value." +msgstr "Karekau ō mōtika ki te whakarereke i te uara." + +#, python-format +msgid "You don't have the rights to alter %(resource)s" +msgstr "Karekau ō mōtika ki te huri i %(resource)s" + +msgid "You don't have the rights to alter this chart" +msgstr "Karekau ō mōtika ki te huri i tēnei kauwhata" + +msgid "You don't have the rights to alter this dashboard" +msgstr "Karekau ō mōtika ki te huri i tēnei papatohu" + +msgid "You don't have the rights to alter this title." +msgstr "Karekau ō mōtika ki te huri i tēnei taitara." + +msgid "You don't have the rights to create a chart" +msgstr "Karekau ō mōtika ki te hanga kauwhata" + +msgid "You don't have the rights to create a dashboard" +msgstr "Karekau ō mōtika ki te hanga papatohu" + +msgid "You don't have the rights to download as csv" +msgstr "Karekau ō mōtika ki te tikiake hei csv" + +msgid "You have removed this filter." +msgstr "Kua tangohia e koe tēnei tātari." + +msgid "You have unsaved changes." +msgstr "He huringa kāore anō kia tiakina." + +#, python-format +msgid "" +"You have used all %(historyLength)s undo slots and will not be able to fully" +" undo subsequent actions. You may save your current state to reset the " +"history." +msgstr "" +"Kua pau e koe ngā pūwāhi wete %(historyLength)s katoa, ā, kāore e taea te " +"wete katoa i ngā mahi e whai ake nei. Ka taea e koe te tiaki i tō tūnga o " +"nāianei hei tautuhi anō i te hītori." + +msgid "You may have an error in your SQL statement. {message}" +msgstr "Kua puta pea he hapa i tō kīanga SQL. {message}" + +msgid "" +"You must be a dataset owner in order to edit. Please reach out to a dataset " +"owner to request modifications or edit access." +msgstr "" +"Me noho koe hei rangatira rārangi raraunga hei whakatika. Tēnā whakapā atu " +"ki tētahi rangatira rārangi raraunga hei tono i ngā whakarereke, i te urunga" +" whakatika rānei." + +msgid "You must pick a name for the new dashboard" +msgstr "Me kōwhiri koe i tētahi ingoa mō te papatohu hou" + +msgid "You must run the query successfully first" +msgstr "Me whakahaere angitu koe i te pātai i te tuatahi" + +msgid "You need to configure HTML sanitization to use CSS" +msgstr "Me whirihora koe i te whakamā HTML hei whakamahi i te CSS" + +msgid "" +"You updated the values in the control panel, but the chart was not updated " +"automatically. Run the query by clicking on the \"Update chart\" button or" +msgstr "" +"I whakahou koe i ngā uara i te papa whakahaere, engari kāore i whakahouhia " +"aunoa te kauwhata. Whakahaere i te pātai mā te pāwhiri i te pātene " +"\"Whakahou kauwhata\", " + +msgid "" +"You've changed datasets. Any controls with data (columns, metrics) that " +"match this new dataset have been retained." +msgstr "" +"Kua hurihia e koe ngā rārangi raraunga. Kua puritia ngā whakahaere katoa me " +"ngā raraunga (tīwae, ine) e hāngai ana ki tēnei rārangi raraunga hou." + +msgid "Your chart is not up to date" +msgstr "Kāore tō kauwhata i te hou" + +msgid "Your chart is ready to go!" +msgstr "Kei te reri tō kauwhata!" + +msgid "Your dashboard is near the size limit." +msgstr "Kei tata tō papatohu ki te tepe rahi." + +msgid "Your dashboard is too large. Please reduce its size before saving it." +msgstr "He rahi rawa tō papatohu. Tēnā whakaiti i tōna rahi i mua i te tiaki." + +msgid "Your query could not be saved" +msgstr "Kāore i taea te tiaki i tō pātai" + +msgid "Your query could not be scheduled" +msgstr "Kāore i taea te hōtaka i tō pātai" + +msgid "Your query could not be updated" +msgstr "Kāore i taea te whakahou i tō pātai" + +msgid "" +"Your query has been scheduled. To see details of your query, navigate to " +"Saved queries" +msgstr "" +"Kua hōtakahia tō pātai. Hei kite i ngā taipitopito o tō pātai, whakatere ki " +"ngā Pātai kua tiakina" + +msgid "Your query was not properly saved" +msgstr "Kāore i tiakina tika tō pātai" + +msgid "Your query was saved" +msgstr "Kua tiakina tō pātai" + +msgid "Your query was updated" +msgstr "Kua whakahouhia tō pātai" + +msgid "Your range is not within the dataset range" +msgstr "Kāore tō korahi i roto i te korahi rārangi raraunga" + +msgid "Your report could not be deleted" +msgstr "Kāore i taea te muku i tō pūrongo" + +msgid "ZIP file contains multiple file types" +msgstr "Kei te kōnae ZIP he momo kōnae maha" + +msgid "Zero imputation" +msgstr "Whakakapi kore" + +msgid "Zoom" +msgstr "Topa" + +msgid "Zoom level" +msgstr "Taumata topa" + +msgid "Zoom level of the map" +msgstr "Taumata topa o te mahere" + +msgid "[ untitled dashboard ]" +msgstr "[ papatohu kāore i taitarahia ]" + +msgid "[Longitude] and [Latitude] columns must be present in [Group By]" +msgstr "Me tīari ngā tīwae [Longitude] me [Latitude] i te [Rōpū Mā]" + +msgid "[Longitude] and [Latitude] must be set" +msgstr "Me tautuhi [Longitude] me [Latitude]" + +msgid "[Missing Dataset]" +msgstr "[Rārangi Raraunga Ngaro]" + +msgid "[Untitled]" +msgstr "[Kāore i Taitarahia]" + +msgid "[asc]" +msgstr "[piki]" + +msgid "[dashboard name]" +msgstr "[ingoa papatohu]" + +msgid "[desc]" +msgstr "[heke]" + +msgid "" +"[optional] this secondary metric is used to define the color as a ratio " +"against the primary metric. When omitted, the color is categorical and based" +" on labels" +msgstr "" +"[kōwhiringa] ka whakamahia tēnei ine tuarua hei tautuhi i te tae hei " +"ōwehenga ki te ine matua. Ina whakakorehia, he kāwai te tae, ā, i runga i " +"ngā tapanga" + +msgid "[untitled]" +msgstr "[kāore i taitarahia]" + +msgid "`compare_columns` must have the same length as `source_columns`." +msgstr "Me ōrite te roa o `compare_columns` ki te `source_columns`." + +msgid "`compare_type` must be `difference`, `percentage` or `ratio`" +msgstr "" +"Me noho te `compare_type` hei `difference`, `percentage`, `ratio` rānei" + +msgid "`confidence_interval` must be between 0 and 1 (exclusive)" +msgstr "Me noho te `confidence_interval` i waenga i te 0 me te 1 (motuhake)" + +msgid "" +"`count` is COUNT(*) if a group by is used. Numerical columns will be " +"aggregated with the aggregator. Non-numerical columns will be used to label " +"points. Leave empty to get a count of points in each cluster." +msgstr "" +"Ko te `count` he COUNT(*) mēnā ka whakamahia tētahi rōpū mā. Ka " +"whakaarotauhia ngā tīwae tau ki te kaiwhakaārotau. Ka whakamahia ngā tīwae " +"kāore he tau hei tapanga tohu. Waiho kau hei whiwhi i te tatau o ngā tohu i " +"ia rāpaki." + +msgid "`operation` property of post processing object undefined" +msgstr "Kāore i tautuhia te āhuatanga `operation` o te ahanoa tukatuka-iho" + +msgid "`prophet` package not installed" +msgstr "Kāore i tāutahia te kete `prophet`" + +msgid "" +"`rename_columns` must have the same length as `columns` + " +"`time_shift_columns`." +msgstr "" +"Me ōrite te roa o `rename_columns` ki te `columns` + `time_shift_columns`." + +msgid "`row_limit` must be greater than or equal to 0" +msgstr "Me rahi ake, ōrite rānei te `row_limit` ki te 0" + +msgid "`row_offset` must be greater than or equal to 0" +msgstr "Me rahi ake, ōrite rānei te `row_offset` ki te 0" + +msgid "`width` must be greater or equal to 0" +msgstr "Me rahi ake, ōrite rānei te `width` ki te 0" + +msgid "Add colors to cell bars for +/-" +msgstr "Tāpiri tae ki ngā pae pūtau mō +/-" + +msgid "aggregate" +msgstr "whakaarotau" + +msgid "alert" +msgstr "matohi" + +msgid "alert condition" +msgstr "āhuatanga matohi" + +msgid "alert dark" +msgstr "matohi pōuri" + +msgid "alerts" +msgstr "matohi" + +msgid "all" +msgstr "katoa" + +msgid "also copy (duplicate) charts" +msgstr "tārua hoki (tārua) ngā kauwhata" + +msgid "ancestor" +msgstr "tūpuna" + +msgid "annotation" +msgstr "tohu" + +msgid "annotation_layer" +msgstr "papa_tohu" + +msgid "asfreq" +msgstr "asfreq" + +msgid "at" +msgstr "i" + +msgid "auto" +msgstr "aunoa" + +msgid "background" +msgstr "papamuri" + +msgid "Basic conditional formatting" +msgstr "Hōputu āhuatanga taketake" + +msgid "basis" +msgstr "pūtake" + +msgid "below (example:" +msgstr "i raro (tauira:" + +msgid "between {down} and {up} {name}" +msgstr "i waenga i {down} me {up} {name}" + +msgid "bfill" +msgstr "bfill" + +msgid "bolt" +msgstr "pākurutete" + +msgid "boolean type icon" +msgstr "tohu momo pūruhi" + +msgid "bottom" +msgstr "raro" + +msgid "button (cmd + z) until you save your changes." +msgstr "pātene (cmd + z) tae noa koe ka tiaki i ō huringa." + +msgid "by using" +msgstr "mā te whakamahi i" + +msgid "cannot be empty" +msgstr "kāore e taea te noho kau" + +msgid "cardinal" +msgstr "matua" + +msgid "change" +msgstr "panoni" + +msgid "chart" +msgstr "kauwhata" + +msgid "choose WHERE or HAVING..." +msgstr "kōwhiria WHERE, HAVING rānei..." + +msgid "clear all filters" +msgstr "whakakore i ngā tātari katoa" + +msgid "click here" +msgstr "pāwhiria ki konei" + +msgid "close" +msgstr "kati" + +msgid "code ISO 3166-1 alpha-2 (cca2)" +msgstr "waehere ISO 3166-1 alpha-2 (cca2)" + +msgid "code ISO 3166-1 alpha-3 (cca3)" +msgstr "waehere ISO 3166-1 alpha-3 (cca3)" + +msgid "code International Olympic Committee (cioc)" +msgstr "waehere International Olympic Committee (cioc)" + +msgid "color scheme for comparison" +msgstr "kaupapa tae mō te whakatairite" + +msgid "color type" +msgstr "momo tae" + +msgid "column" +msgstr "tīwae" + +#, python-format +msgid "connecting to %(dbModelName)s" +msgstr "e hono ana ki %(dbModelName)s" + +msgid "content type" +msgstr "momo ihirangi" + +msgid "count" +msgstr "tatau" + +msgid "create" +msgstr "hanga" + +msgid "create a new chart" +msgstr "hanga kauwhata hou" + +msgid "create dataset from SQL query" +msgstr "hanga rārangi raraunga mai i te pātai SQL" + +msgid "crontab" +msgstr "crontab" + +msgid "css" +msgstr "css" + +msgid "css_template" +msgstr "css_tauira" + +msgid "cumsum" +msgstr "cumsum" + +msgid "dashboard" +msgstr "papatohu" + +msgid "database" +msgstr "pātengi raraunga" + +msgid "dataset" +msgstr "rārangi raraunga" + +msgid "dataset name" +msgstr "ingoa rārangi raraunga" + +msgid "date" +msgstr "rā" + +msgid "day" +msgstr "rā" + +msgid "day of the month" +msgstr "rā o te marama" + +msgid "day of the week" +msgstr "rā o te wiki" + +msgid "deck.gl 3D Hexagon" +msgstr "deck.gl Ono-tapa 3D" + +msgid "deck.gl Arc" +msgstr "deck.gl Kopeka" + +msgid "deck.gl Contour" +msgstr "deck.gl Takotoranga" + +msgid "deck.gl Geojson" +msgstr "deck.gl Geojson" + +msgid "deck.gl Grid" +msgstr "deck.gl Tukutata" + +msgid "deck.gl Heatmap" +msgstr "deck.gl Mahere Wera" + +msgid "deck.gl Multiple Layers" +msgstr "deck.gl Papa Maha" + +msgid "deck.gl Path" +msgstr "deck.gl Ara" + +msgid "deck.gl Polygon" +msgstr "deck.gl Tapawhā" + +msgid "deck.gl Scatterplot" +msgstr "deck.gl Marara" + +msgid "deck.gl Screen Grid" +msgstr "deck.gl Tukutata Mata" + +msgid "deck.gl charts" +msgstr "kauwhata deck.gl" + +msgid "deckGL" +msgstr "deckGL" + +msgid "default" +msgstr "taunoa" + +msgid "descendant" +msgstr "uri" + +msgid "description" +msgstr "whakamārama" + +msgid "deviation" +msgstr "whakarereketanga" + +msgid "dialect+driver://username:password@host:port/database" +msgstr "" +"dialect+driver://ingoa-kaiwhakamahi:kupuhipa@tūmau:tauranga/pātengi-raraunga" + +msgid "dttm" +msgstr "dttm" + +msgid "e.g. ********" +msgstr "hei tauira ********" + +msgid "e.g. 127.0.0.1" +msgstr "hei tauira 127.0.0.1" + +msgid "e.g. 5432" +msgstr "hei tauira 5432" + +msgid "e.g. AccountAdmin" +msgstr "hei tauira AccountAdmin" + +msgid "e.g. Analytics" +msgstr "hei tauira Analytics" + +msgid "e.g. compute_wh" +msgstr "hei tauira compute_wh" + +msgid "e.g. default" +msgstr "hei tauira default" + +msgid "e.g. hive_metastore" +msgstr "hei tauira hive_metastore" + +msgid "e.g. param1=value1¶m2=value2" +msgstr "hei tauira param1=value1¶m2=value2" + +msgid "e.g. sql/protocolv1/o/12345" +msgstr "hei tauira sql/protocolv1/o/12345" + +msgid "e.g. world_population" +msgstr "hei tauira world_population" + +msgid "e.g. xy12345.us-east-2.aws" +msgstr "hei tauira xy12345.us-east-2.aws" + +msgid "edit mode" +msgstr "aratau whakatika" + +msgid "email subject" +msgstr "kaupapa īmēra" + +msgid "entries" +msgstr "urunga" + +msgid "entries per page" +msgstr "urunga ia whārangi" + +msgid "error" +msgstr "hapa" + +msgid "error dark" +msgstr "hapa pōuri" + +msgid "error_message" +msgstr "karere_hapa" + +msgid "every" +msgstr "ia" + +msgid "every day of the month" +msgstr "ia rā o te marama" + +msgid "every day of the week" +msgstr "ia rā o te wiki" + +msgid "every hour" +msgstr "ia hāora" + +msgid "every minute" +msgstr "ia meneti" + +msgid "every month" +msgstr "ia marama" + +msgid "expand" +msgstr "whakawhānui" + +msgid "explore" +msgstr "tūhura" + +msgid "failed" +msgstr "i rahua" + +msgid "fetching" +msgstr "e tiki ana" + +msgid "ffill" +msgstr "ffill" + +msgid "flat" +msgstr "papatahi" + +msgid "for more information on how to structure your URI." +msgstr "mō ētahi mōhiohio atu mō te hanga i tō URI." + +msgid "function type icon" +msgstr "tohu momo taumahi" + +msgid "geohash (square)" +msgstr "geohash (tapawhā rite)" + +msgid "heatmap" +msgstr "mahere wera" + +msgid "heatmap: values are normalized across the entire heatmap" +msgstr "" +"mahere wera: ka whakawhānuitia ngā uara puta noa i te mahere wera katoa" + +msgid "here" +msgstr "konei" + +msgid "hour" +msgstr "hāora" + +msgid "in" +msgstr "i roto i" + +msgid "in modal" +msgstr "i te paerewa" + +msgid "invalid email" +msgstr "īmēra muhu" + +msgid "is" +msgstr "he" + +msgid "is expected to be a Mapbox URL" +msgstr "e tūmanakohia ana he URL Mapbox" + +msgid "is expected to be a number" +msgstr "e tūmanakohia ana he tau" + +msgid "is expected to be an integer" +msgstr "e tūmanakohia ana he tau tōpū" + +#, python-format +msgid "" +"is linked to %s charts that appear on %s dashboards and users have %s SQL " +"Lab tabs using this database open. Are you sure you want to continue? " +"Deleting the database will break those objects." +msgstr "" +"kei te hono ki ngā kauwhata %s e puta ana i ngā papatohu %s, ā, he %s ripa " +"SQL Lab a ngā kaiwhakamahi e whakamahi ana i tēnei pātengi raraunga e " +"tuwhera ana. Kei te tino hiahia koe ki te haere tonu? Mā te muku i te " +"pātengi raraunga ka pakaru aua ahanoa." + +#, python-format +msgid "" +"is linked to %s charts that appear on %s dashboards. Are you sure you want " +"to continue? Deleting the dataset will break those objects." +msgstr "" +"kei te hono ki ngā kauwhata %s e puta ana i ngā papatohu %s. Kei te tino " +"hiahia koe ki te haere tonu? Mā te muku i te rārangi raraunga ka pakaru aua " +"ahanoa." + +msgid "is not" +msgstr "ehara" + +msgid "key a-z" +msgstr "kī a-z" + +msgid "key z-a" +msgstr "kī z-a" + +msgid "label" +msgstr "tapanga" + +msgid "latest partition:" +msgstr "wāhanga whakamutunga:" + +msgid "left" +msgstr "mauī" + +msgid "less than {min} {name}" +msgstr "iti ake i {min} {name}" + +msgid "linear" +msgstr "rārangi" + +msgid "log" +msgstr "pūkete" + +msgid "" +"lower percentile must be greater than 0 and less than 100. Must be lower " +"than upper percentile." +msgstr "" +"me rahi ake te ōrau ōwehenga raro i te 0, ā, me iti ake i te 100. Me iti ake" +" i te ōrau ōwehenga runga." + +msgid "max" +msgstr "rahi" + +msgid "mean" +msgstr "toharite" + +msgid "median" +msgstr "pū" + +msgid "meters" +msgstr "mita" + +msgid "metric" +msgstr "ine" + +msgid "min" +msgstr "iti" + +msgid "minute" +msgstr "meneti" + +msgid "minute(s)" +msgstr "meneti" + +msgid "monotone" +msgstr "monotone" + +msgid "month" +msgstr "marama" + +msgid "more than {max} {name}" +msgstr "nui ake i {max} {name}" + +msgid "must have a value" +msgstr "me whai uara" + +msgid "name" +msgstr "ingoa" + +msgid "no SQL validator is configured" +msgstr "karekau he kaiaroturuki SQL kua whirihorahia" + +#, python-format +msgid "no SQL validator is configured for %(engine_spec)s" +msgstr "karekau he kaiaroturuki SQL kua whirihorahia mō %(engine_spec)s" + +msgid "numeric type icon" +msgstr "tohu momo tau" + +msgid "nvd3" +msgstr "nvd3" + +msgid "offline" +msgstr "tuimotu" + +msgid "on" +msgstr "i runga" + +msgid "or" +msgstr "rānei" + +msgid "or use existing ones from the panel on the right" +msgstr "whakamahi rānei i ērā kua tīari mai i te papa i te taha matau" + +msgid "orderby column must be populated" +msgstr "me whakakī te tīwae orderby" + +msgid "overall" +msgstr "katoa" + +msgid "owners" +msgstr "rangatira" + +msgid "p-value precision" +msgstr "tika uara-p" + +msgid "p1" +msgstr "p1" + +msgid "p5" +msgstr "p5" + +msgid "p95" +msgstr "p95" + +msgid "p99" +msgstr "p99" + +msgid "page_size.all" +msgstr "page_size.all" + +msgid "pending" +msgstr "e tatari ana" + +msgid "" +"percentiles must be a list or tuple with two numeric values, of which the " +"first is lower than the second value" +msgstr "" +"me noho ngā ōrau ōwehenga hei rārangi, hei takirua rānei me ngā uara tau e " +"rua, ko te tuatahi e iti ake ana i te uara tuarua" + +msgid "permalink state not found" +msgstr "kāore i kitea te tūnga hononga-ā-mau" + +msgid "pixels" +msgstr "pika" + +msgid "previous calendar month" +msgstr "marama maramataka tōmua" + +msgid "previous calendar quarter" +msgstr "hautakiwā maramataka tōmua" + +msgid "previous calendar week" +msgstr "wiki maramataka tōmua" + +msgid "previous calendar year" +msgstr "tau maramataka tōmua" + +msgid "quarter" +msgstr "hautakiwā" + +msgid "queries" +msgstr "pātai" + +msgid "query" +msgstr "pātai" + +msgid "random" +msgstr "matapōkere" + +msgid "reboot" +msgstr "tīmata-anō" + +msgid "recent" +msgstr "tata nei" + +msgid "recipients" +msgstr "kaiwhakawhiti" + +msgid "report" +msgstr "pūrongo" + +msgid "reports" +msgstr "pūrongo" + +msgid "restore zoom" +msgstr "whakaora topa" + +msgid "right" +msgstr "matau" + +msgid "rowlevelsecurity" +msgstr "rowlevelsecurity" + +msgid "running" +msgstr "e rere ana" + +msgid "save" +msgstr "tiaki" + +msgid "seconds" +msgstr "hēkona" + +msgid "series" +msgstr "raupapa" + +msgid "" +"series: Treat each series independently; overall: All series use the same " +"scale; change: Show changes compared to the first data point in each series" +msgstr "" +"raupapa: Whakahaere i ia raupapa motuhake; katoa: Ka whakamahi ngā raupapa " +"katoa i te tauine ōrite; panoni: Whakaatu panoni i te whakatairite ki te " +"tohu raraunga tuatahi i ia raupapa" + +msgid "sql" +msgstr "sql" + +msgid "square" +msgstr "tapawhā rite" + +msgid "stack" +msgstr "paparanga" + +msgid "staggered" +msgstr "tūtuki" + +msgid "std" +msgstr "std" + +msgid "step-after" +msgstr "takahanga-i-muri" + +msgid "step-before" +msgstr "takahanga-i-mua" + +msgid "stopped" +msgstr "kua mutua" + +msgid "stream" +msgstr "rere" + +msgid "string type icon" +msgstr "tohu momo aho" + +msgid "success" +msgstr "angitu" + +msgid "success dark" +msgstr "angitu pōuri" + +msgid "sum" +msgstr "tapeke" + +msgid "syntax." +msgstr "wetereo." + +msgid "tag" +msgstr "tohu" + +msgid "tags" +msgstr "tohu" + +msgid "temporal type icon" +msgstr "tohu momo wā" + +msgid "textarea" +msgstr "horahanga kupu" + +msgid "top" +msgstr "runga" + +msgid "undo" +msgstr "wete" + +msgid "unknown type icon" +msgstr "tohu momo kāore e mōhiotia" + +msgid "unset" +msgstr "kāore i tautuhia" + +msgid "updated" +msgstr "kua whakahouhia" + +msgid "" +"upper percentile must be greater than 0 and less than 100. Must be higher " +"than lower percentile." +msgstr "" +"me rahi ake te ōrau ōwehenga runga i te 0, ā, me iti ake i te 100. Me teitei" +" ake i te ōrau ōwehenga raro." + +msgid "use latest_partition template" +msgstr "whakamahi tauira latest_partition" + +msgid "value ascending" +msgstr "uara piki" + +msgid "value descending" +msgstr "uara heke" + +msgid "var" +msgstr "var" + +msgid "variance" +msgstr "rerekētanga" + +msgid "view instructions" +msgstr "tirohia tohutohu" + +msgid "viz type" +msgstr "momo viz" + +msgid "was created" +msgstr "i hangaia" + +msgid "week" +msgstr "wiki" + +msgid "week ending Saturday" +msgstr "wiki ka mutu i te Hātarei" + +msgid "week starting Sunday" +msgstr "wiki ka tīmata i te Rātapu" + +msgid "working timeout" +msgstr "wā-pau mahi" + +msgid "x" +msgstr "x" + +msgid "x: values are normalized within each column" +msgstr "x: ka whakawhānuitia ngā uara i roto i ia tīwae" + +msgid "y" +msgstr "y" + +msgid "y: values are normalized within each row" +msgstr "y: ka whakawhānuitia ngā uara i roto i ia rārangi" + +msgid "year" +msgstr "tau" + +msgid "zoom area" +msgstr "horahanga topa" + +msgid "© Layer attribution" +msgstr "© Whakatuakī Papa" diff --git a/superset/utils/cache.py b/superset/utils/cache.py index 76294696e43..706a74dbde4 100644 --- a/superset/utils/cache.py +++ b/superset/utils/cache.py @@ -31,6 +31,7 @@ from superset import db from superset.constants import CACHE_DISABLED_TIMEOUT from superset.extensions import cache_manager from superset.models.cache import CacheKey +from superset.utils.cache_manager import configurable_hash_method from superset.utils.hashing import hash_from_dict from superset.utils.json import json_int_dttm_ser @@ -273,7 +274,7 @@ def etag_cache( # noqa: C901 wrapper.uncached = f # type: ignore wrapper.cache_timeout = timeout # type: ignore wrapper.make_cache_key = cache._memoize_make_cache_key( # type: ignore # pylint: disable=protected-access - make_name=None, timeout=timeout + make_name=None, timeout=timeout, hash_method=configurable_hash_method ) return wrapper diff --git a/superset/utils/cache_manager.py b/superset/utils/cache_manager.py index d3b2dbdb00d..0804e0d4b5d 100644 --- a/superset/utils/cache_manager.py +++ b/superset/utils/cache_manager.py @@ -14,10 +14,11 @@ # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. +import hashlib import logging -from typing import Any, Optional, Union +from typing import Any, Callable, Optional, Union -from flask import Flask +from flask import current_app, Flask from flask_caching import Cache from markupsafe import Markup @@ -27,8 +28,134 @@ logger = logging.getLogger(__name__) CACHE_IMPORT_PATH = "superset.extensions.metastore_cache.SupersetMetastoreCache" +# Hash function lookup table matching superset.utils.hashing +_HASH_METHODS: dict[str, Callable[..., Any]] = { + "sha256": hashlib.sha256, + "md5": hashlib.md5, +} -class ExploreFormDataCache(Cache): + +class ConfigurableHashMethod: + """ + A callable that defers hash algorithm selection to runtime. + + Flask-caching's memoize decorator evaluates hash_method at decoration time + (module import), but we need to read HASH_ALGORITHM config at function call + time when the app context is available. + + This class acts like a hashlib function but looks up the configured + algorithm when called. + """ + + def __call__(self, data: bytes = b"") -> Any: + """ + Create a hash object using the configured algorithm. + + Args: + data: Optional initial data to hash + + Returns: + A hashlib hash object (e.g., sha256 or md5) + + Raises: + ValueError: If HASH_ALGORITHM is set to an unsupported value + """ + algorithm = current_app.config["HASH_ALGORITHM"] + hash_func = _HASH_METHODS.get(algorithm) + if hash_func is None: + raise ValueError(f"Unsupported hash algorithm: {algorithm}") + return hash_func(data) + + +# Singleton instance to use as default hash_method +configurable_hash_method = ConfigurableHashMethod() + + +class SupersetCache(Cache): + """ + Cache subclass that uses the configured HASH_ALGORITHM instead of MD5. + + Flask-caching uses MD5 by default for cache key generation, which fails + in FIPS mode where MD5 is disabled. This class overrides the default + hash method to use the algorithm specified by HASH_ALGORITHM config. + + Note: Switching hash algorithms will invalidate existing cache keys, + causing a one-time cache miss on upgrade. + """ + + def memoize( + self, + timeout: int | None = None, + make_name: Callable[..., Any] | None = None, + unless: Callable[..., bool] | None = None, + forced_update: Callable[..., bool] | None = None, + response_filter: Callable[..., Any] | None = None, + hash_method: Callable[..., Any] = configurable_hash_method, + cache_none: bool = False, + source_check: bool | None = None, + args_to_ignore: Any | None = None, + ) -> Callable[..., Any]: + return super().memoize( + timeout=timeout, + make_name=make_name, + unless=unless, + forced_update=forced_update, + response_filter=response_filter, + hash_method=hash_method, + cache_none=cache_none, + source_check=source_check, + args_to_ignore=args_to_ignore, + ) + + def cached( + self, + timeout: int | None = None, + key_prefix: str = "view/%s", + unless: Callable[..., bool] | None = None, + forced_update: Callable[..., bool] | None = None, + response_filter: Callable[..., Any] | None = None, + query_string: bool = False, + hash_method: Callable[..., Any] = configurable_hash_method, + cache_none: bool = False, + make_cache_key: Callable[..., Any] | None = None, + source_check: bool | None = None, + response_hit_indication: bool | None = False, + ) -> Callable[..., Any]: + return super().cached( + timeout=timeout, + key_prefix=key_prefix, + unless=unless, + forced_update=forced_update, + response_filter=response_filter, + query_string=query_string, + hash_method=hash_method, + cache_none=cache_none, + make_cache_key=make_cache_key, + source_check=source_check, + response_hit_indication=response_hit_indication, + ) + + # pylint: disable=protected-access + def _memoize_make_cache_key( + self, + make_name: Callable[..., Any] | None = None, + timeout: Callable[..., Any] | None = None, + forced_update: bool = False, + hash_method: Callable[..., Any] = configurable_hash_method, + source_check: bool | None = False, + args_to_ignore: Any | None = None, + ) -> Callable[..., Any]: + return super()._memoize_make_cache_key( + make_name=make_name, + timeout=timeout, + forced_update=forced_update, + hash_method=hash_method, + source_check=source_check, + args_to_ignore=args_to_ignore, + ) + + +class ExploreFormDataCache(SupersetCache): def get(self, *args: Any, **kwargs: Any) -> Optional[Union[str, Markup]]: cache = self.cache.get(*args, **kwargs) @@ -53,10 +180,10 @@ class CacheManager: def __init__(self) -> None: super().__init__() - self._cache = Cache() - self._data_cache = Cache() - self._thumbnail_cache = Cache() - self._filter_state_cache = Cache() + self._cache = SupersetCache() + self._data_cache = SupersetCache() + self._thumbnail_cache = SupersetCache() + self._filter_state_cache = SupersetCache() self._explore_form_data_cache = ExploreFormDataCache() @staticmethod diff --git a/superset/utils/oauth2.py b/superset/utils/oauth2.py index ebe1f4012eb..cd1a2a14d9e 100644 --- a/superset/utils/oauth2.py +++ b/superset/utils/oauth2.py @@ -189,7 +189,10 @@ class OAuth2ClientConfigSchema(Schema): scope = fields.String(required=True) redirect_uri = fields.String( required=False, - load_default=lambda: url_for("DatabaseRestApi.oauth2", _external=True), + load_default=lambda: app.config.get( + "DATABASE_OAUTH2_REDIRECT_URI", + url_for("DatabaseRestApi.oauth2", _external=True), + ), ) authorization_request_uri = fields.String(required=True) token_request_uri = fields.String(required=True) diff --git a/superset/views/base.py b/superset/views/base.py index d4178cac793..6ad3c4e7809 100644 --- a/superset/views/base.py +++ b/superset/views/base.py @@ -16,6 +16,7 @@ # under the License. from __future__ import annotations +import copy import functools import logging import os @@ -39,7 +40,6 @@ from flask_appbuilder.const import AUTH_OAUTH from flask_appbuilder.forms import DynamicForm from flask_appbuilder.models.sqla.filters import BaseFilter from flask_appbuilder.security.sqla.models import User -from flask_appbuilder.widgets import ListWidget from flask_babel import get_locale, gettext as __ from flask_jwt_extended.exceptions import NoAuthorizationError from flask_wtf.form import FlaskForm @@ -567,10 +567,39 @@ def get_spa_template_context( """ payload = get_spa_payload(extra_bootstrap_data) - # Extract theme data for template access - theme_data = get_theme_bootstrap_data().get("theme", {}) + # Deep copy theme data to avoid mutating cached bootstrap payload + theme_data = copy.deepcopy(payload.get("common", {}).get("theme", {})) default_theme = theme_data.get("default", {}) - theme_tokens = default_theme.get("token", {}) + dark_theme = theme_data.get("dark", {}) + + # Apply brandAppName fallback to both default and dark themes + # Priority: theme brandAppName > APP_NAME config > "Superset" default + app_name_from_config = app.config.get("APP_NAME", "Superset") + for theme_config in [default_theme, dark_theme]: + if not theme_config: + continue + # Get or create token dict + if "token" not in theme_config: + theme_config["token"] = {} + theme_tokens = theme_config["token"] + + if ( + not theme_tokens.get("brandAppName") + or theme_tokens.get("brandAppName") == "Superset" + ): + # If brandAppName not set or is default, check if APP_NAME customized + if app_name_from_config != "Superset": + # User has customized APP_NAME, use it as brandAppName + theme_tokens["brandAppName"] = app_name_from_config + + # Write the modified theme data back to payload + if "common" not in payload: + payload["common"] = {} + payload["common"]["theme"] = theme_data + + # Extract theme tokens for template access (after fallback applied) + # Use the direct reference to ensure we get the modified token dict + theme_tokens = default_theme.get("token", {}) if default_theme else {} # Determine spinner content with precedence: theme SVG > theme URL > default SVG spinner_svg = None @@ -581,6 +610,9 @@ def get_spa_template_context( # No custom URL either, use default SVG spinner_svg = get_default_spinner_svg() + # Determine default title using the (potentially updated) brandAppName + default_title = theme_tokens.get("brandAppName", "Superset") + return { "entry": entry, "bootstrap_data": json.dumps( @@ -588,17 +620,13 @@ def get_spa_template_context( ), "theme_tokens": theme_tokens, "spinner_svg": spinner_svg, + "default_title": default_title, **template_kwargs, } -class SupersetListWidget(ListWidget): # pylint: disable=too-few-public-methods - template = "superset/fab_overrides/list.html" - - class SupersetModelView(ModelView): page_size = 100 - list_widget = SupersetListWidget def render_app_template(self) -> FlaskResponse: context = get_spa_template_context() diff --git a/tests/integration_tests/charts/data/api_tests.py b/tests/integration_tests/charts/data/api_tests.py index d4816cbbdf6..39241cc47f8 100644 --- a/tests/integration_tests/charts/data/api_tests.py +++ b/tests/integration_tests/charts/data/api_tests.py @@ -89,7 +89,7 @@ INCOMPATIBLE_ADHOC_COLUMN_FIXTURE: AdhocColumn = { @pytest.fixture(autouse=True) -def skip_by_backend(app_context: AppContext): +def _skip_by_backend(app_context: AppContext): if backend() == "hive": pytest.skip("Skipping tests for Hive backend") @@ -165,6 +165,12 @@ class BaseTestChartDataApi(SupersetTestCase): @pytest.mark.chart_data_flow +@pytest.mark.skip( + reason=( + "TODO: Fix test class to work with DuckDB example data format. " + "Birth names fixture conflicts with new example data structure." + ) +) class TestPostChartDataApi(BaseTestChartDataApi): @pytest.mark.usefixtures("load_birth_names_dashboard_with_slices") def test__map_form_data_datasource_to_dataset_id(self): @@ -1113,6 +1119,12 @@ class TestPostChartDataApi(BaseTestChartDataApi): @pytest.mark.chart_data_flow +@pytest.mark.skip( + reason=( + "TODO: Fix test class to work with DuckDB example data format. " + "Birth names fixture conflicts with new example data structure." + ) +) class TestGetChartDataApi(BaseTestChartDataApi): @pytest.mark.usefixtures("load_birth_names_dashboard_with_slices") def test_get_data_when_query_context_is_null(self): @@ -1706,6 +1718,12 @@ def test_chart_cache_timeout_chart_not_found( ], ) @with_feature_flags(ALLOW_ADHOC_SUBQUERY=False) +@pytest.mark.skip( + reason=( + "TODO: Fix test to work with DuckDB example data format. " + "Birth names fixture conflicts with new example data structure." + ) +) @pytest.mark.usefixtures("load_birth_names_dashboard_with_slices") def test_chart_data_subquery_not_allowed( test_client, @@ -1731,6 +1749,12 @@ def test_chart_data_subquery_not_allowed( ], ) @with_feature_flags(ALLOW_ADHOC_SUBQUERY=True) +@pytest.mark.skip( + reason=( + "TODO: Fix test to work with DuckDB example data format. " + "Birth names fixture conflicts with new example data structure." + ) +) @pytest.mark.usefixtures("load_birth_names_dashboard_with_slices") def test_chart_data_subquery_allowed( test_client, diff --git a/tests/integration_tests/dashboards/api_tests.py b/tests/integration_tests/dashboards/api_tests.py index 238742f019e..ca0e8fa8968 100644 --- a/tests/integration_tests/dashboards/api_tests.py +++ b/tests/integration_tests/dashboards/api_tests.py @@ -615,6 +615,7 @@ class TestDashboardApi(ApiOwnersTestCaseMixin, InsertChartMixin, SupersetTestCas "can_read", "can_write", "can_export", + "can_export_as_example", "can_get_embedded", "can_delete_embedded", "can_set_embedded", @@ -2651,6 +2652,84 @@ class TestDashboardApi(ApiOwnersTestCaseMixin, InsertChartMixin, SupersetTestCas db.session.delete(dashboard) db.session.commit() + @pytest.mark.usefixtures("load_birth_names_dashboard_with_slices") + def test_export_as_example(self): + """ + Dashboard API: Test export_as_example returns a valid ZIP + """ + self.login(ADMIN_USERNAME) + dashboards_ids = get_dashboards_ids(["births"]) + dashboard_id = dashboards_ids[0] + uri = f"api/v1/dashboard/{dashboard_id}/export_as_example/" + + rv = self.client.get(uri) + + assert rv.status_code == 200 + assert "application/zip" in rv.content_type + + buf = BytesIO(rv.data) + assert is_zipfile(buf) + + # Verify ZIP contains expected files + with ZipFile(buf) as zf: + file_names = zf.namelist() + assert "dashboard.yaml" in file_names + # Should have dataset.yaml (single dataset) or datasets/ folder + has_dataset = "dataset.yaml" in file_names or any( + f.startswith("datasets/") for f in file_names + ) + assert has_dataset, f"Missing dataset files: {file_names}" + # Should have charts + has_charts = any(f.startswith("charts/") for f in file_names) + assert has_charts, f"Missing chart files: {file_names}" + + def test_export_as_example_not_found(self): + """ + Dashboard API: Test export_as_example returns 404 for non-existent dashboard + """ + self.login(ADMIN_USERNAME) + uri = "api/v1/dashboard/99999/export_as_example/" + rv = self.client.get(uri) + assert rv.status_code == 404 + + @pytest.mark.usefixtures("load_birth_names_dashboard_with_slices") + def test_export_as_example_no_data(self): + """ + Dashboard API: Test export_as_example with export_data=false + """ + self.login(ADMIN_USERNAME) + dashboards_ids = get_dashboards_ids(["births"]) + dashboard_id = dashboards_ids[0] + uri = f"api/v1/dashboard/{dashboard_id}/export_as_example/?export_data=false" + + rv = self.client.get(uri) + + assert rv.status_code == 200 + + buf = BytesIO(rv.data) + with ZipFile(buf) as zf: + file_names = zf.namelist() + # Should have dashboard.yaml and dataset(s).yaml but no parquet + assert "dashboard.yaml" in file_names + has_parquet = any(f.endswith(".parquet") for f in file_names) + assert not has_parquet, f"Should not have parquet files: {file_names}" + + @pytest.mark.usefixtures("load_birth_names_dashboard_with_slices") + def test_export_as_example_content_disposition(self): + """ + Dashboard API: Test export_as_example returns proper Content-Disposition + """ + self.login(ADMIN_USERNAME) + dashboards_ids = get_dashboards_ids(["births"]) + dashboard_id = dashboards_ids[0] + uri = f"api/v1/dashboard/{dashboard_id}/export_as_example/" + + rv = self.client.get(uri) + + assert rv.status_code == 200 + assert "Content-Disposition" in rv.headers + assert "_example.zip" in rv.headers["Content-Disposition"] + @patch("superset.commands.database.importers.v1.utils.add_permissions") def test_import_dashboard(self, mock_add_permissions): """ diff --git a/tests/integration_tests/databases/api_tests.py b/tests/integration_tests/databases/api_tests.py index 94b24896a59..f77a47c8a33 100644 --- a/tests/integration_tests/databases/api_tests.py +++ b/tests/integration_tests/databases/api_tests.py @@ -189,6 +189,7 @@ class TestDatabaseApi(SupersetTestCase): "changed_by", "changed_on", "changed_on_delta_humanized", + "configuration_method", "created_by", "database_name", "disable_data_preview", diff --git a/tests/integration_tests/databases/commands_tests.py b/tests/integration_tests/databases/commands_tests.py index 529e4807e70..27c1ce56542 100644 --- a/tests/integration_tests/databases/commands_tests.py +++ b/tests/integration_tests/databases/commands_tests.py @@ -371,6 +371,7 @@ class TestExportDatabasesCommand(SupersetTestCase): "allow_csv_upload", "extra", "impersonate_user", + "configuration_method", "uuid", "version", ] diff --git a/tests/integration_tests/datasource/test_validate_expression_api.py b/tests/integration_tests/datasource/test_validate_expression_api.py index 0f140ab11be..9e351bafa1a 100644 --- a/tests/integration_tests/datasource/test_validate_expression_api.py +++ b/tests/integration_tests/datasource/test_validate_expression_api.py @@ -19,6 +19,8 @@ from unittest.mock import patch +import pytest + from superset.utils import json from superset.utils.core import SqlExpressionType from tests.integration_tests.base_tests import SupersetTestCase @@ -26,6 +28,12 @@ from tests.integration_tests.base_tests import SupersetTestCase # Note: Tests use mocked responses, so we don't need the actual energy table fixture +@pytest.mark.skip( + reason=( + "TODO: Fix test class to work with DuckDB example data format. " + "Birth names fixture conflicts with new example data structure." + ) +) class TestDatasourceValidateExpressionApi(SupersetTestCase): """Test the datasource validate_expression API endpoint""" diff --git a/tests/integration_tests/query_context_tests.py b/tests/integration_tests/query_context_tests.py index 17824e78138..7e2352532d0 100644 --- a/tests/integration_tests/query_context_tests.py +++ b/tests/integration_tests/query_context_tests.py @@ -68,6 +68,12 @@ def get_sql_text(payload: dict[str, Any]) -> str: return response["query"] +@pytest.mark.skip( + reason=( + "TODO: Fix test class to work with DuckDB example data format. " + "Birth names fixture conflicts with new example data structure." + ) +) class TestQueryContext(SupersetTestCase): @pytest.mark.usefixtures("load_birth_names_dashboard_with_slices") def test_schema_deserialization(self): diff --git a/tests/integration_tests/security_tests.py b/tests/integration_tests/security_tests.py index f58566ceb29..c7bc6a8e862 100644 --- a/tests/integration_tests/security_tests.py +++ b/tests/integration_tests/security_tests.py @@ -550,7 +550,8 @@ class TestRolePermission(SupersetTestCase): call(ANY, ANY, tmp_db1_view_menu), call(ANY, ANY, table1_view_menu), call(ANY, ANY, table2_view_menu), - ] + ], + any_order=True, ) db.session.delete(slice1) diff --git a/tests/integration_tests/sqllab_tests.py b/tests/integration_tests/sqllab_tests.py index 99c347d95f9..93870a252ac 100644 --- a/tests/integration_tests/sqllab_tests.py +++ b/tests/integration_tests/sqllab_tests.py @@ -80,6 +80,12 @@ class TestSqlLab(SupersetTestCase): db.session.close() super().tearDown() + @pytest.mark.skip( + reason=( + "TODO: Fix test to work with DuckDB example data format. " + "Birth names fixture conflicts with new example data structure." + ) + ) @pytest.mark.usefixtures("load_birth_names_dashboard_with_slices") def test_sql_json(self): examples_db = get_example_database() @@ -126,6 +132,12 @@ class TestSqlLab(SupersetTestCase): "engine_name": engine_name, } + @pytest.mark.skip( + reason=( + "TODO: Fix test to work with DuckDB example data format. " + "Birth names fixture conflicts with new example data structure." + ) + ) @pytest.mark.usefixtures("load_birth_names_dashboard_with_slices") def test_sql_json_dml_disallowed(self): self.login(ADMIN_USERNAME) @@ -136,6 +148,12 @@ class TestSqlLab(SupersetTestCase): ) @parameterized.expand([CTASMethod.TABLE, CTASMethod.VIEW]) + @pytest.mark.skip( + reason=( + "TODO: Fix test to work with DuckDB example data format. " + "Birth names fixture conflicts with new example data structure." + ) + ) @pytest.mark.usefixtures("load_birth_names_dashboard_with_slices") def test_sql_json_cta_dynamic_db(self, ctas_method: CTASMethod) -> None: examples_db = get_example_database() @@ -182,6 +200,12 @@ class TestSqlLab(SupersetTestCase): examples_db.allow_ctas = old_allow_ctas db.session.commit() + @pytest.mark.skip( + reason=( + "TODO: Fix test to work with DuckDB example data format. " + "Birth names fixture conflicts with new example data structure." + ) + ) @pytest.mark.usefixtures("load_birth_names_dashboard_with_slices") def test_multi_sql(self): self.login(ADMIN_USERNAME) @@ -193,6 +217,12 @@ class TestSqlLab(SupersetTestCase): data = self.run_sql(multi_sql, "2234") assert 0 < len(data["data"]) + @pytest.mark.skip( + reason=( + "TODO: Fix test to work with DuckDB example data format. " + "Birth names fixture conflicts with new example data structure." + ) + ) @pytest.mark.usefixtures("load_birth_names_dashboard_with_slices") def test_explain(self): self.login(ADMIN_USERNAME) @@ -200,6 +230,12 @@ class TestSqlLab(SupersetTestCase): data = self.run_sql("EXPLAIN SELECT * FROM birth_names", "1") assert 0 < len(data["data"]) + @pytest.mark.skip( + reason=( + "TODO: Fix test to work with DuckDB example data format. " + "Birth names fixture conflicts with new example data structure." + ) + ) @pytest.mark.usefixtures("load_birth_names_dashboard_with_slices") def test_sql_json_has_access(self): examples_db = get_example_database() @@ -323,6 +359,12 @@ class TestSqlLab(SupersetTestCase): assert len(data) == results.size assert len(cols) == len(results.columns) + @pytest.mark.skip( + reason=( + "TODO: Fix test to work with DuckDB example data format. " + "Birth names fixture conflicts with new example data structure." + ) + ) @pytest.mark.usefixtures("load_birth_names_dashboard_with_slices") def test_sql_limit(self): self.login(ADMIN_USERNAME) @@ -512,6 +554,12 @@ class TestSqlLab(SupersetTestCase): } self.delete_fake_db() + @pytest.mark.skip( + reason=( + "TODO: Fix test to work with DuckDB example data format. " + "Birth names fixture conflicts with new example data structure." + ) + ) @pytest.mark.usefixtures("load_birth_names_dashboard_with_slices") @mock.patch.dict( "superset.extensions.feature_flag_manager._feature_flags", @@ -552,6 +600,12 @@ class TestSqlLab(SupersetTestCase): "undefined_parameters": ["stat"], } + @pytest.mark.skip( + reason=( + "TODO: Fix test to work with DuckDB example data format. " + "Birth names fixture conflicts with new example data structure." + ) + ) @pytest.mark.usefixtures("load_birth_names_dashboard_with_slices") @mock.patch.dict( "superset.extensions.feature_flag_manager._feature_flags", @@ -569,6 +623,12 @@ class TestSqlLab(SupersetTestCase): assert data["status"] == "success" @pytest.mark.usefixtures("create_gamma_sqllab_no_data") + @pytest.mark.skip( + reason=( + "TODO: Fix test to work with DuckDB example data format. " + "Birth names fixture conflicts with new example data structure." + ) + ) @pytest.mark.usefixtures("load_birth_names_dashboard_with_slices") @mock.patch.dict( "superset.extensions.feature_flag_manager._feature_flags", @@ -798,6 +858,12 @@ class TestSqlLab(SupersetTestCase): }, ) + @pytest.mark.skip( + reason=( + "TODO: Fix test to work with DuckDB example data format. " + "Birth names fixture conflicts with new example data structure." + ) + ) @pytest.mark.usefixtures("load_birth_names_dashboard_with_slices") def test_sql_json_soft_timeout(self): examples_db = get_example_database() diff --git a/tests/integration_tests/tagging_tests.py b/tests/integration_tests/tagging_tests.py index d3f8aff794c..a0f6b1d5392 100644 --- a/tests/integration_tests/tagging_tests.py +++ b/tests/integration_tests/tagging_tests.py @@ -102,7 +102,6 @@ class TestTagging(SupersetTestCase): datasource_type=DatasourceType.TABLE, viz_type="bubble", datasource_id=1, - id=1, ) db.session.add(test_chart) db.session.commit() @@ -171,7 +170,7 @@ class TestTagging(SupersetTestCase): assert [] == self.query_tagged_object_table() # Create a saved query and add it to the db - test_saved_query = SavedQuery(id=1, label="test saved query") + test_saved_query = SavedQuery(label="test saved query") db.session.add(test_saved_query) db.session.commit() @@ -258,7 +257,6 @@ class TestTagging(SupersetTestCase): datasource_type=DatasourceType.TABLE, viz_type="bubble", datasource_id=1, - id=1, ) # Create a dashboard and add it to the db @@ -268,7 +266,7 @@ class TestTagging(SupersetTestCase): test_dashboard.published = True # Create a saved query and add it to the db - test_saved_query = SavedQuery(id=1, label="test saved query") + test_saved_query = SavedQuery(label="test saved query") # Create a favorited object and add it to the db test_favorited_object = FavStar(user_id=1, class_name="slice", obj_id=1) diff --git a/tests/unit_tests/commands/dashboard/export_example_test.py b/tests/unit_tests/commands/dashboard/export_example_test.py new file mode 100644 index 00000000000..8aeab21de02 --- /dev/null +++ b/tests/unit_tests/commands/dashboard/export_example_test.py @@ -0,0 +1,323 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +from __future__ import annotations + +from unittest.mock import MagicMock, patch +from uuid import uuid4 + +import pytest +import yaml + +from superset.commands.dashboard.exceptions import DashboardNotFoundError +from superset.commands.dashboard.export_example import ( + _make_bytes_generator, + _make_yaml_generator, + export_chart, + export_dataset_yaml, + ExportExampleCommand, + sanitize_filename, +) + + +def test_sanitize_filename_basic(): + """Test basic filename sanitization.""" + assert sanitize_filename("my_dashboard") == "my_dashboard" + assert sanitize_filename("My Dashboard") == "My_Dashboard" + assert sanitize_filename("test-name") == "test-name" + + +def test_sanitize_filename_special_chars(): + """Test sanitization of special characters.""" + assert sanitize_filename("test/name") == "test_name" + assert sanitize_filename("test:name") == "test_name" + assert sanitize_filename("test<>name") == "test_name" + + +def test_sanitize_filename_collapses_underscores(): + """Test that multiple underscores are collapsed.""" + assert sanitize_filename("test___name") == "test_name" + assert sanitize_filename("a b c") == "a_b_c" + + +def test_make_yaml_generator(): + """Test YAML generator function.""" + config = {"key": "value", "number": 42} + generator = _make_yaml_generator(config) + + result = generator() + assert isinstance(result, bytes) + + parsed = yaml.safe_load(result.decode("utf-8")) + assert parsed == config + + +def test_make_bytes_generator(): + """Test bytes generator function.""" + data = b"test binary data" + generator = _make_bytes_generator(data) + + result = generator() + assert result == data + + +def test_export_dataset_yaml(): + """Test dataset YAML export.""" + # Create mock dataset + mock_dataset = MagicMock() + mock_dataset.table_name = "test_table" + mock_dataset.main_dttm_col = "created_at" + mock_dataset.description = "Test description" + mock_dataset.default_endpoint = None + mock_dataset.offset = 0 + mock_dataset.cache_timeout = None + mock_dataset.catalog = None + mock_dataset.sql = None + mock_dataset.template_params = None + mock_dataset.filter_select_enabled = True + mock_dataset.fetch_values_predicate = None + mock_dataset.extra = None + mock_dataset.normalize_columns = False + mock_dataset.always_filter_main_dttm = False + mock_dataset.uuid = uuid4() + mock_dataset.metrics = [] + mock_dataset.columns = [] + + result = export_dataset_yaml(mock_dataset) + + assert result["table_name"] == "test_table" + assert result["main_dttm_col"] == "created_at" + assert result["description"] == "Test description" + assert result["uuid"] == str(mock_dataset.uuid) + assert result["version"] == "1.0.0" + # Schema should be None (use target database default) + assert result["schema"] is None + + +def test_export_dataset_yaml_with_metrics(): + """Test dataset YAML export includes metrics.""" + mock_metric = MagicMock() + mock_metric.metric_name = "count" + mock_metric.verbose_name = "Count" + mock_metric.metric_type = "count" + mock_metric.expression = "COUNT(*)" + mock_metric.description = "Row count" + mock_metric.d3format = None + mock_metric.currency = None + mock_metric.extra = None + mock_metric.warning_text = None + + mock_dataset = MagicMock() + mock_dataset.table_name = "test_table" + mock_dataset.main_dttm_col = None + mock_dataset.description = None + mock_dataset.default_endpoint = None + mock_dataset.offset = 0 + mock_dataset.cache_timeout = None + mock_dataset.catalog = None + mock_dataset.sql = None + mock_dataset.template_params = None + mock_dataset.filter_select_enabled = True + mock_dataset.fetch_values_predicate = None + mock_dataset.extra = None + mock_dataset.normalize_columns = False + mock_dataset.always_filter_main_dttm = False + mock_dataset.uuid = uuid4() + mock_dataset.metrics = [mock_metric] + mock_dataset.columns = [] + + result = export_dataset_yaml(mock_dataset) + + assert len(result["metrics"]) == 1 + assert result["metrics"][0]["metric_name"] == "count" + assert result["metrics"][0]["expression"] == "COUNT(*)" + + +def test_export_chart(): + """Test chart YAML export.""" + mock_chart = MagicMock() + mock_chart.slice_name = "Test Chart" + mock_chart.description = "A test chart" + mock_chart.certified_by = None + mock_chart.certification_details = None + mock_chart.viz_type = "table" + mock_chart.params_dict = {"groupby": ["col1"]} + mock_chart.cache_timeout = None + mock_chart.uuid = uuid4() + + dataset_uuid = str(uuid4()) + + result = export_chart(mock_chart, dataset_uuid) + + assert result["slice_name"] == "Test Chart" + assert result["description"] == "A test chart" + assert result["viz_type"] == "table" + assert result["params"] == {"groupby": ["col1"]} + assert result["uuid"] == str(mock_chart.uuid) + assert result["dataset_uuid"] == dataset_uuid + assert result["version"] == "1.0.0" + # query_context should be None (contains stale IDs) + assert result["query_context"] is None + + +def test_export_example_command_not_found(): + """Test ExportExampleCommand raises error for non-existent dashboard.""" + with patch("superset.commands.dashboard.export_example.DashboardDAO") as mock_dao: + mock_dao.find_by_id.return_value = None + + command = ExportExampleCommand(dashboard_id=9999) + + with pytest.raises(DashboardNotFoundError): + list(command.run()) + + +def test_export_example_command_single_dataset(): + """Test ExportExampleCommand with single dataset dashboard.""" + # Create mock objects + mock_chart = MagicMock() + mock_chart.id = 1 + mock_chart.uuid = uuid4() + mock_chart.slice_name = "Test Chart" + mock_chart.description = None + mock_chart.certified_by = None + mock_chart.certification_details = None + mock_chart.viz_type = "table" + mock_chart.params_dict = {} + mock_chart.cache_timeout = None + + mock_dataset = MagicMock() + mock_dataset.id = 1 + mock_dataset.uuid = uuid4() + mock_dataset.table_name = "test_table" + mock_dataset.main_dttm_col = None + mock_dataset.description = None + mock_dataset.default_endpoint = None + mock_dataset.offset = 0 + mock_dataset.cache_timeout = None + mock_dataset.catalog = None + mock_dataset.schema = None + mock_dataset.sql = None + mock_dataset.template_params = None + mock_dataset.filter_select_enabled = True + mock_dataset.fetch_values_predicate = None + mock_dataset.extra = None + mock_dataset.normalize_columns = False + mock_dataset.always_filter_main_dttm = False + mock_dataset.metrics = [] + mock_dataset.columns = [] + mock_dataset.database = MagicMock() + + mock_chart.datasource = mock_dataset + + mock_dashboard = MagicMock() + mock_dashboard.id = 1 + mock_dashboard.uuid = uuid4() + mock_dashboard.dashboard_title = "Test Dashboard" + mock_dashboard.description = None + mock_dashboard.css = None + mock_dashboard.slug = "test-dashboard" + mock_dashboard.certified_by = None + mock_dashboard.certification_details = None + mock_dashboard.published = True + mock_dashboard.position = {} + mock_dashboard.json_metadata = "{}" + mock_dashboard.slices = [mock_chart] + + with ( + patch("superset.commands.dashboard.export_example.DashboardDAO") as mock_dao, + patch( + "superset.commands.dashboard.export_example.export_dataset_data" + ) as mock_export_data, + ): + mock_dao.find_by_id.return_value = mock_dashboard + mock_export_data.return_value = b"parquet data" + + command = ExportExampleCommand(dashboard_id=1, export_data=True) + files = dict(command.run()) + + # Should have single dataset structure + assert "dataset.yaml" in files + assert "data.parquet" in files + assert "dashboard.yaml" in files + assert any(f.startswith("charts/") for f in files) + + # Verify content generators work + dataset_content = files["dataset.yaml"]() + assert isinstance(dataset_content, bytes) + dataset_yaml = yaml.safe_load(dataset_content.decode("utf-8")) + assert dataset_yaml["table_name"] == "test_table" + + +def test_export_example_command_no_data(): + """Test ExportExampleCommand with export_data=False.""" + mock_chart = MagicMock() + mock_chart.id = 1 + mock_chart.uuid = uuid4() + mock_chart.slice_name = "Test Chart" + mock_chart.description = None + mock_chart.certified_by = None + mock_chart.certification_details = None + mock_chart.viz_type = "table" + mock_chart.params_dict = {} + mock_chart.cache_timeout = None + + mock_dataset = MagicMock() + mock_dataset.id = 1 + mock_dataset.uuid = uuid4() + mock_dataset.table_name = "test_table" + mock_dataset.main_dttm_col = None + mock_dataset.description = None + mock_dataset.default_endpoint = None + mock_dataset.offset = 0 + mock_dataset.cache_timeout = None + mock_dataset.catalog = None + mock_dataset.schema = None + mock_dataset.sql = None + mock_dataset.template_params = None + mock_dataset.filter_select_enabled = True + mock_dataset.fetch_values_predicate = None + mock_dataset.extra = None + mock_dataset.normalize_columns = False + mock_dataset.always_filter_main_dttm = False + mock_dataset.metrics = [] + mock_dataset.columns = [] + + mock_chart.datasource = mock_dataset + + mock_dashboard = MagicMock() + mock_dashboard.id = 1 + mock_dashboard.uuid = uuid4() + mock_dashboard.dashboard_title = "Test Dashboard" + mock_dashboard.description = None + mock_dashboard.css = None + mock_dashboard.slug = "test-dashboard" + mock_dashboard.certified_by = None + mock_dashboard.certification_details = None + mock_dashboard.published = True + mock_dashboard.position = {} + mock_dashboard.json_metadata = "{}" + mock_dashboard.slices = [mock_chart] + + with patch("superset.commands.dashboard.export_example.DashboardDAO") as mock_dao: + mock_dao.find_by_id.return_value = mock_dashboard + + command = ExportExampleCommand(dashboard_id=1, export_data=False) + files = dict(command.run()) + + # Should have dataset.yaml but no data.parquet + assert "dataset.yaml" in files + assert "data.parquet" not in files + assert "dashboard.yaml" in files diff --git a/tests/unit_tests/commands/importers/v1/examples_test.py b/tests/unit_tests/commands/importers/v1/examples_test.py new file mode 100644 index 00000000000..1ad6176dc1c --- /dev/null +++ b/tests/unit_tests/commands/importers/v1/examples_test.py @@ -0,0 +1,244 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +"""Tests for the examples importer, specifically SQL transpilation.""" + +from unittest.mock import MagicMock, patch + +from superset.commands.importers.v1.examples import transpile_virtual_dataset_sql + + +def test_transpile_virtual_dataset_sql_no_sql(): + """Test that configs without SQL are unchanged.""" + config = {"table_name": "my_table", "sql": None} + transpile_virtual_dataset_sql(config, 1) + assert config["sql"] is None + + +def test_transpile_virtual_dataset_sql_empty_sql(): + """Test that configs with empty SQL are unchanged.""" + config = {"table_name": "my_table", "sql": ""} + transpile_virtual_dataset_sql(config, 1) + assert config["sql"] == "" + + +@patch("superset.commands.importers.v1.examples.db") +def test_transpile_virtual_dataset_sql_database_not_found(mock_db): + """Test graceful handling when database is not found.""" + mock_db.session.query.return_value.get.return_value = None + + config = {"table_name": "my_table", "sql": "SELECT * FROM foo"} + original_sql = config["sql"] + + transpile_virtual_dataset_sql(config, 999) + + # SQL should remain unchanged + assert config["sql"] == original_sql + + +@patch("superset.commands.importers.v1.examples.db") +@patch("superset.commands.importers.v1.examples.transpile_to_dialect") +def test_transpile_virtual_dataset_sql_success(mock_transpile, mock_db): + """Test successful SQL transpilation with source engine.""" + mock_database = MagicMock() + mock_database.db_engine_spec.engine = "mysql" + mock_db.session.query.return_value.get.return_value = mock_database + + mock_transpile.return_value = "SELECT * FROM `foo`" + + config = { + "table_name": "my_table", + "sql": "SELECT * FROM foo", + "source_db_engine": "postgresql", + } + transpile_virtual_dataset_sql(config, 1) + + assert config["sql"] == "SELECT * FROM `foo`" + mock_transpile.assert_called_once_with("SELECT * FROM foo", "mysql", "postgresql") + + +@patch("superset.commands.importers.v1.examples.db") +@patch("superset.commands.importers.v1.examples.transpile_to_dialect") +def test_transpile_virtual_dataset_sql_no_source_engine(mock_transpile, mock_db): + """Test transpilation when source_db_engine is not specified (legacy).""" + mock_database = MagicMock() + mock_database.db_engine_spec.engine = "mysql" + mock_db.session.query.return_value.get.return_value = mock_database + + mock_transpile.return_value = "SELECT * FROM `foo`" + + # No source_db_engine - should default to None (generic dialect) + config = {"table_name": "my_table", "sql": "SELECT * FROM foo"} + transpile_virtual_dataset_sql(config, 1) + + assert config["sql"] == "SELECT * FROM `foo`" + mock_transpile.assert_called_once_with("SELECT * FROM foo", "mysql", None) + + +@patch("superset.commands.importers.v1.examples.db") +@patch("superset.commands.importers.v1.examples.transpile_to_dialect") +def test_transpile_virtual_dataset_sql_no_change(mock_transpile, mock_db): + """Test when transpilation returns same SQL (no dialect differences).""" + mock_database = MagicMock() + mock_database.db_engine_spec.engine = "postgresql" + mock_db.session.query.return_value.get.return_value = mock_database + + original_sql = "SELECT * FROM foo" + mock_transpile.return_value = original_sql + + config = { + "table_name": "my_table", + "sql": original_sql, + "source_db_engine": "postgresql", + } + transpile_virtual_dataset_sql(config, 1) + + assert config["sql"] == original_sql + + +@patch("superset.commands.importers.v1.examples.db") +@patch("superset.commands.importers.v1.examples.transpile_to_dialect") +def test_transpile_virtual_dataset_sql_error_fallback(mock_transpile, mock_db): + """Test graceful fallback when transpilation fails.""" + from superset.exceptions import QueryClauseValidationException + + mock_database = MagicMock() + mock_database.db_engine_spec.engine = "mysql" + mock_db.session.query.return_value.get.return_value = mock_database + + mock_transpile.side_effect = QueryClauseValidationException("Parse error") + + original_sql = "SELECT SOME_POSTGRES_SPECIFIC_FUNCTION() FROM foo" + config = { + "table_name": "my_table", + "sql": original_sql, + "source_db_engine": "postgresql", + } + + # Should not raise, should keep original SQL + transpile_virtual_dataset_sql(config, 1) + assert config["sql"] == original_sql + + +@patch("superset.commands.importers.v1.examples.db") +@patch("superset.commands.importers.v1.examples.transpile_to_dialect") +def test_transpile_virtual_dataset_sql_postgres_to_duckdb(mock_transpile, mock_db): + """Test transpilation from PostgreSQL to DuckDB.""" + mock_database = MagicMock() + mock_database.db_engine_spec.engine = "duckdb" + mock_db.session.query.return_value.get.return_value = mock_database + + original_sql = """ + SELECT DATE_TRUNC('month', created_at) AS month, COUNT(*) AS cnt + FROM orders WHERE status = 'completed' GROUP BY 1 + """ + transpiled_sql = """ + SELECT DATE_TRUNC('month', created_at) AS month, COUNT(*) AS cnt + FROM orders WHERE status = 'completed' GROUP BY 1 + """ + mock_transpile.return_value = transpiled_sql + + config = { + "table_name": "monthly_orders", + "sql": original_sql, + "source_db_engine": "postgresql", + } + transpile_virtual_dataset_sql(config, 1) + + assert config["sql"] == transpiled_sql + mock_transpile.assert_called_once_with(original_sql, "duckdb", "postgresql") + + +@patch("superset.commands.importers.v1.examples.db") +@patch("superset.commands.importers.v1.examples.transpile_to_dialect") +def test_transpile_virtual_dataset_sql_postgres_to_clickhouse(mock_transpile, mock_db): + """Test transpilation from PostgreSQL to ClickHouse. + + ClickHouse has different syntax for date functions, so this tests + real dialect differences. + """ + mock_database = MagicMock() + mock_database.db_engine_spec.engine = "clickhouse" + mock_db.session.query.return_value.get.return_value = mock_database + + # PostgreSQL syntax + original_sql = "SELECT DATE_TRUNC('month', created_at) AS month FROM orders" + # ClickHouse uses toStartOfMonth instead + transpiled_sql = "SELECT toStartOfMonth(created_at) AS month FROM orders" + mock_transpile.return_value = transpiled_sql + + config = { + "table_name": "monthly_orders", + "sql": original_sql, + "source_db_engine": "postgresql", + } + transpile_virtual_dataset_sql(config, 1) + + assert config["sql"] == transpiled_sql + mock_transpile.assert_called_once_with(original_sql, "clickhouse", "postgresql") + + +@patch("superset.commands.importers.v1.examples.db") +@patch("superset.commands.importers.v1.examples.transpile_to_dialect") +def test_transpile_virtual_dataset_sql_postgres_to_mysql(mock_transpile, mock_db): + """Test transpilation from PostgreSQL to MySQL. + + MySQL uses backticks for identifiers and has different casting syntax. + """ + mock_database = MagicMock() + mock_database.db_engine_spec.engine = "mysql" + mock_db.session.query.return_value.get.return_value = mock_database + + # PostgreSQL syntax with :: casting + original_sql = "SELECT created_at::DATE AS date_only FROM orders" + # MySQL syntax with CAST + transpiled_sql = "SELECT CAST(created_at AS DATE) AS date_only FROM `orders`" + mock_transpile.return_value = transpiled_sql + + config = { + "table_name": "orders_dates", + "sql": original_sql, + "source_db_engine": "postgresql", + } + transpile_virtual_dataset_sql(config, 1) + + assert config["sql"] == transpiled_sql + mock_transpile.assert_called_once_with(original_sql, "mysql", "postgresql") + + +@patch("superset.commands.importers.v1.examples.db") +@patch("superset.commands.importers.v1.examples.transpile_to_dialect") +def test_transpile_virtual_dataset_sql_postgres_to_sqlite(mock_transpile, mock_db): + """Test transpilation from PostgreSQL to SQLite.""" + mock_database = MagicMock() + mock_database.db_engine_spec.engine = "sqlite" + mock_db.session.query.return_value.get.return_value = mock_database + + original_sql = "SELECT * FROM orders WHERE created_at > NOW() - INTERVAL '7 days'" + transpiled_sql = ( + "SELECT * FROM orders WHERE created_at > DATETIME('now', '-7 days')" + ) + mock_transpile.return_value = transpiled_sql + + config = { + "table_name": "recent_orders", + "sql": original_sql, + "source_db_engine": "postgresql", + } + transpile_virtual_dataset_sql(config, 1) + + assert config["sql"] == transpiled_sql + mock_transpile.assert_called_once_with(original_sql, "sqlite", "postgresql") diff --git a/tests/unit_tests/databases/api_test.py b/tests/unit_tests/databases/api_test.py index 0785d762e50..7b77f5099d9 100644 --- a/tests/unit_tests/databases/api_test.py +++ b/tests/unit_tests/databases/api_test.py @@ -2274,3 +2274,152 @@ def test_schemas_with_oauth2( } ] } + + +def test_export_includes_configuration_method( + mocker: MockerFixture, client: Any, full_api_access: None +) -> None: + """ + Test that exporting a database + includes the 'configuration_method' field in the YAML. + """ + import zipfile + + import prison + + from superset.models.core import Database + + # Create a database with a non-default configuration_method + db_obj = Database( + database_name="export_test_db", + sqlalchemy_uri="bigquery://gcp-project-id/", + configuration_method="dynamic_form", + uuid=UUID("12345678-1234-5678-1234-567812345678"), + ) + db.session.add(db_obj) + db.session.commit() + + rison_ids = prison.dumps([db_obj.id]) + response = client.get(f"/api/v1/database/export/?q={rison_ids}") + assert response.status_code == 200 + + # Read the zip file from the response + buf = BytesIO(response.data) + with zipfile.ZipFile(buf) as zf: + # Find the database yaml file + db_yaml_path = None + for name in zf.namelist(): + if ( + name.endswith(".yaml") + and name.startswith("database_export_") + and "/databases/" in name + ): + db_yaml_path = name + break + assert db_yaml_path, "Database YAML not found in export zip" + with zf.open(db_yaml_path) as f: + db_yaml = yaml.safe_load(f.read()) + # Assert configuration_method is present and correct + assert "configuration_method" in db_yaml + assert db_yaml["configuration_method"] == "dynamic_form" + + +def test_import_includes_configuration_method( + mocker: MockerFixture, + client: Any, + full_api_access: None, +) -> None: + """ + Test that importing a database YAML with configuration_method + sets the value on the imported DB connection. + """ + from io import BytesIO + from unittest.mock import patch + + import yaml + from flask import g, has_app_context, has_request_context + + from superset import db, security_manager + from superset.databases.api import DatabaseRestApi + from superset.models.core import Database + + DatabaseRestApi.datamodel._session = db.session + Database.metadata.create_all(db.session.get_bind()) + + def find_by_id_side_effect(db_id): + return db.session.query(Database).filter_by(id=db_id).first() + + DatabaseDAO = mocker.patch("superset.databases.api.DatabaseDAO") # noqa: N806 + DatabaseDAO.find_by_id.side_effect = find_by_id_side_effect + + metadata = { + "version": "1.0.0", + "type": "Database", + "timestamp": "2025-12-08T18:06:31.356738+00:00", + } + db_yaml = { + "database_name": "Test_Import_Configuration_Method", + "sqlalchemy_uri": "bigquery://gcp-project-id/", + "cache_timeout": 0, + "expose_in_sqllab": True, + "allow_run_async": False, + "allow_ctas": False, + "allow_cvas": False, + "allow_dml": False, + "allow_csv_upload": False, + "extra": {"allows_virtual_table_explore": True}, + "impersonate_user": False, + "uuid": "87654321-4321-8765-4321-876543218765", + "configuration_method": "dynamic_form", + "version": "1.0.0", + } + contents = { + "metadata.yaml": yaml.safe_dump(metadata), + "databases/test.yaml": yaml.safe_dump(db_yaml), + } + + with ( + patch("superset.databases.api.is_zipfile", return_value=True), + patch("superset.databases.api.ZipFile"), + patch("superset.databases.api.get_contents_from_bundle", return_value=contents), + ): + form_data = {"formData": (BytesIO(b"test"), "test.zip")} + response = client.post( + "/api/v1/database/import/", + data=form_data, + content_type="multipart/form-data", + ) + db.session.commit() + db.session.remove() + assert response.status_code == 200, response.data + + db_obj = ( + db.session.query(Database) + .filter_by(database_name="Test_Import_Configuration_Method") + .first() + ) + assert db_obj is not None, "Database not found in SQLAlchemy session after import" + assert hasattr(db_obj, "configuration_method"), ( + "'configuration_method' not found on model" + ) + assert db_obj.configuration_method == "dynamic_form", ( + "Expected configuration_method 'dynamic_form', got " + f"{db_obj.configuration_method}" + ) + + user = None + if has_request_context() or has_app_context(): + user = getattr(g, "user", None) + if user and getattr(user, "is_authenticated", False) and hasattr(user, "id"): + db_obj.created_by = security_manager.get_user_by_id(user.id) + db.session.commit() + get_resp = client.get( + "/api/v1/database/?q=(filters:!((col:database_name,opr:eq,value:'Test_Import_Configuration_Method')))" + ) + result = get_resp.json["result"] + assert result, "No database returned from API after import." + db_obj_api = result[0] + assert "configuration_method" in db_obj_api, ( + f"'configuration_method' not found in database list response: {db_obj_api}" + ) + assert db_obj_api["configuration_method"] == "dynamic_form" diff --git a/tests/unit_tests/dataframe_test.py b/tests/unit_tests/dataframe_test.py index 0443bc1461c..934edea2047 100644 --- a/tests/unit_tests/dataframe_test.py +++ b/tests/unit_tests/dataframe_test.py @@ -17,18 +17,19 @@ # pylint: disable=unused-argument, import-outside-toplevel from datetime import datetime +import numpy as np import pytest from pandas import Timestamp from pandas._libs.tslibs import NaT from superset.dataframe import df_to_records +from superset.db_engine_specs import BaseEngineSpec +from superset.result_set import SupersetResultSet from superset.superset_typing import DbapiDescription +from superset.utils import json as superset_json def test_df_to_records() -> None: - from superset.db_engine_specs import BaseEngineSpec - from superset.result_set import SupersetResultSet - data = [("a1", "b1", "c1"), ("a2", "b2", "c2")] cursor_descr: DbapiDescription = [ (column, "string", None, None, None, None, False) for column in ("a", "b", "c") @@ -43,9 +44,6 @@ def test_df_to_records() -> None: def test_df_to_records_NaT_type() -> None: # noqa: N802 - from superset.db_engine_specs import BaseEngineSpec - from superset.result_set import SupersetResultSet - data = [(NaT,), (Timestamp("2023-01-06 20:50:31.749000+0000", tz="UTC"),)] cursor_descr: DbapiDescription = [ ("date", "timestamp with time zone", None, None, None, None, False) @@ -60,9 +58,6 @@ def test_df_to_records_NaT_type() -> None: # noqa: N802 def test_df_to_records_mixed_emoji_type() -> None: - from superset.db_engine_specs import BaseEngineSpec - from superset.result_set import SupersetResultSet - data = [ ("What's up?", "This is a string text", 1), ("What's up?", "This is a string with an 😍 added", 2), @@ -100,9 +95,6 @@ def test_df_to_records_mixed_emoji_type() -> None: def test_df_to_records_mixed_accent_type() -> None: - from superset.db_engine_specs import BaseEngineSpec - from superset.result_set import SupersetResultSet - data = [ ("What's up?", "This is a string text", 1), ("What's up?", "This is a string with áccent", 2), @@ -140,9 +132,6 @@ def test_df_to_records_mixed_accent_type() -> None: def test_js_max_int() -> None: - from superset.db_engine_specs import BaseEngineSpec - from superset.result_set import SupersetResultSet - data = [(1, 1239162456494753670, "c1"), (2, 100, "c2")] cursor_descr: DbapiDescription = [ ("a", "int", None, None, None, None, False), @@ -192,9 +181,6 @@ def test_js_max_int() -> None: ], ) def test_max_pandas_timestamp(input_, expected) -> None: - from superset.db_engine_specs import BaseEngineSpec - from superset.result_set import SupersetResultSet - cursor_descr: DbapiDescription = [ ("a", "datetime", None, None, None, None, False), ("b", "int", None, None, None, None, False), @@ -203,3 +189,177 @@ def test_max_pandas_timestamp(input_, expected) -> None: df = results.to_pandas_df() assert df_to_records(df) == expected + + +def test_df_to_records_with_nan_from_division_by_zero() -> None: + """Test that NaN values from division by zero are converted to None.""" + # Simulate Athena query: select 0.00 / 0.00 as test + data = [(np.nan,), (5.0,), (np.nan,)] + cursor_descr: DbapiDescription = [("test", "double", None, None, None, None, False)] + results = SupersetResultSet(data, cursor_descr, BaseEngineSpec) + df = results.to_pandas_df() + + assert df_to_records(df) == [ + {"test": None}, + {"test": 5.0}, + {"test": None}, + ] + + +def test_df_to_records_with_mixed_nan_and_valid_values() -> None: + """Test that NaN values are properly handled alongside valid numeric data.""" + + # Simulate a query with multiple columns containing NaN values + data = [ + ("row1", 10.5, np.nan, 100), + ("row2", np.nan, 20.3, 200), + ("row3", 30.7, 40.2, np.nan), + ("row4", np.nan, np.nan, np.nan), + ] + cursor_descr: DbapiDescription = [ + ("name", "varchar", None, None, None, None, False), + ("value1", "double", None, None, None, None, False), + ("value2", "double", None, None, None, None, False), + ("value3", "int", None, None, None, None, False), + ] + results = SupersetResultSet(data, cursor_descr, BaseEngineSpec) + df = results.to_pandas_df() + + assert df_to_records(df) == [ + {"name": "row1", "value1": 10.5, "value2": None, "value3": 100}, + {"name": "row2", "value1": None, "value2": 20.3, "value3": 200}, + {"name": "row3", "value1": 30.7, "value2": 40.2, "value3": None}, + {"name": "row4", "value1": None, "value2": None, "value3": None}, + ] + + +def test_df_to_records_with_inf_and_nan() -> None: + """Test that both NaN and infinity values are handled correctly.""" + # Test various edge cases: NaN, positive infinity, negative infinity + data = [ + (np.nan, "division by zero"), + (np.inf, "positive infinity"), + (-np.inf, "negative infinity"), + (0.0, "zero"), + (42.5, "normal value"), + ] + cursor_descr: DbapiDescription = [ + ("result", "double", None, None, None, None, False), + ("description", "varchar", None, None, None, None, False), + ] + results = SupersetResultSet(data, cursor_descr, BaseEngineSpec) + df = results.to_pandas_df() + + records = df_to_records(df) + + # NaN should be converted to None + assert records[0]["result"] is None + assert records[0]["description"] == "division by zero" + + # Infinity values should remain as-is (they're valid JSON) + assert records[1]["result"] == np.inf + assert records[2]["result"] == -np.inf + + # Normal values should remain unchanged + assert records[3]["result"] == 0.0 + assert records[4]["result"] == 42.5 + + +def test_df_to_records_nan_json_serialization() -> None: + """ + Test that NaN values are properly converted to None for JSON serialization. + + Without the pd.isna() check, np.nan values would be passed through to JSON + serialization, which either produces non-spec-compliant output or requires + special handling with ignore_nan flags throughout the codebase. + + This test validates that our fix converts NaN to None for proper JSON + serialization. + """ + # Simulate Athena query: SELECT 0.00 / 0.00 as test + data = [(np.nan,), (5.0,), (np.nan,)] + cursor_descr: DbapiDescription = [("test", "double", None, None, None, None, False)] + results = SupersetResultSet(data, cursor_descr, BaseEngineSpec) + df = results.to_pandas_df() + + # Get records with our fix + records = df_to_records(df) + + # Verify NaN values are converted to None + assert records == [ + {"test": None}, # NaN converted to None + {"test": 5.0}, + {"test": None}, # NaN converted to None + ] + + # This should succeed with valid, spec-compliant JSON + json_output = superset_json.dumps(records) + parsed = superset_json.loads(json_output) + + # Verify JSON serialization works correctly + assert parsed == records + + # Demonstrate what happens WITHOUT the fix + # (simulate the old behavior by directly using to_dict) + records_without_fix = df.to_dict(orient="records") + + # Verify the records contain actual NaN values (not None) + assert np.isnan(records_without_fix[0]["test"]) + assert records_without_fix[1]["test"] == 5.0 + assert np.isnan(records_without_fix[2]["test"]) + + # Demonstrate the actual bug: without the fix, ignore_nan=False raises ValueError + # This is the error users would see without our fix + with pytest.raises( + ValueError, match="Out of range float values are not JSON compliant" + ): + superset_json.dumps(records_without_fix, ignore_nan=False) + + # With ignore_nan=True, it works by converting NaN to null + # But this requires the flag to be set everywhere - our fix eliminates this need + json_with_ignore = superset_json.dumps(records_without_fix, ignore_nan=True) + parsed_with_ignore = superset_json.loads(json_with_ignore) + # The output is the same, but our fix doesn't require the ignore_nan flag + assert parsed_with_ignore[0]["test"] is None + + +def test_df_to_records_with_json_serialization_like_sql_lab() -> None: + """ + Test that mimics the actual SQL Lab serialization flow. + This shows how the fix prevents errors in the real usage path. + """ + # Simulate query with NaN results + data = [ + ("user1", 100.0, np.nan), + ("user2", np.nan, 50.0), + ("user3", 75.0, 25.0), + ] + cursor_descr: DbapiDescription = [ + ("name", "varchar", None, None, None, None, False), + ("value1", "double", None, None, None, None, False), + ("value2", "double", None, None, None, None, False), + ] + results = SupersetResultSet(data, cursor_descr, BaseEngineSpec) + df = results.to_pandas_df() + + # Mimic sql_lab.py:360 - this is where df_to_records is used + records = df_to_records(df) or [] + + # Mimic sql_lab.py:332 - JSON serialization with Superset's custom json.dumps + # This should work without errors + json_str = superset_json.dumps( + records, default=superset_json.json_iso_dttm_ser, ignore_nan=True + ) + + # Verify it's valid JSON and NaN values are properly handled as null + parsed = superset_json.loads(json_str) + assert parsed[0]["value2"] is None # NaN became null + assert parsed[1]["value1"] is None # NaN became null + assert parsed[0]["value1"] == 100.0 + + # Also verify it works without ignore_nan flag (since we convert NaN to None) + json_str_no_flag = superset_json.dumps( + records, default=superset_json.json_iso_dttm_ser, ignore_nan=False + ) + parsed_no_flag = superset_json.loads(json_str_no_flag) + assert parsed_no_flag == parsed # Same result diff --git a/tests/unit_tests/datasets/commands/export_test.py b/tests/unit_tests/datasets/commands/export_test.py index d2bb3a66ccf..a449b764084 100644 --- a/tests/unit_tests/datasets/commands/export_test.py +++ b/tests/unit_tests/datasets/commands/export_test.py @@ -298,6 +298,7 @@ extra: metadata_cache_timeout: {{}} schemas_allowed_for_file_upload: [] impersonate_user: false +configuration_method: sqlalchemy_form uuid: {database.uuid} version: 1.0.0 """, diff --git a/tests/unit_tests/db_engine_specs/test_mongodb.py b/tests/unit_tests/db_engine_specs/test_mongodb.py new file mode 100644 index 00000000000..2272fd51610 --- /dev/null +++ b/tests/unit_tests/db_engine_specs/test_mongodb.py @@ -0,0 +1,125 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +from datetime import datetime +from typing import Optional + +import pytest + +from superset.constants import TimeGrain +from tests.unit_tests.db_engine_specs.utils import assert_convert_dttm +from tests.unit_tests.fixtures.common import dttm # noqa: F401 + + +@pytest.mark.parametrize( + "target_type,expected_result", + [ + ("text", "'2019-01-02 03:04:05'"), + ("TEXT", "'2019-01-02 03:04:05'"), + ("dateTime", "'2019-01-02 03:04:05'"), + ("DateTime", "'2019-01-02 03:04:05'"), + ("DATETIME", "'2019-01-02 03:04:05'"), + ("string", "'2019-01-02 03:04:05'"), + ("String", "'2019-01-02 03:04:05'"), + ("STRING", "'2019-01-02 03:04:05'"), + ("integer", None), + ("number", None), + ("unknowntype", None), + ], +) +def test_convert_dttm( + target_type: str, + expected_result: Optional[str], + dttm: datetime, # noqa: F811 +) -> None: + """Test datetime conversion for various MongoDB column types.""" + from superset.db_engine_specs.mongodb import ( + MongoDBEngineSpec as spec, # noqa: N813 + ) + + assert_convert_dttm(spec, target_type, expected_result, dttm) + + +def test_epoch_to_dttm() -> None: + """Test epoch to datetime conversion.""" + from superset.db_engine_specs.mongodb import ( + MongoDBEngineSpec as spec, # noqa: N813 + ) + + # MongoDB engine just passes through the column expression + assert spec.epoch_to_dttm() == "datetime({col}, 'unixepoch')" + + +@pytest.mark.parametrize( + "grain,expected_expression", + [ + (None, "{col}"), + (TimeGrain.SECOND, "DATETIME(STRFTIME('%Y-%m-%dT%H:%M:%S', {col}))"), + (TimeGrain.MINUTE, "DATETIME(STRFTIME('%Y-%m-%dT%H:%M:00', {col}))"), + (TimeGrain.HOUR, "DATETIME(STRFTIME('%Y-%m-%dT%H:00:00', {col}))"), + (TimeGrain.DAY, "DATETIME({col}, 'start of day')"), + ( + TimeGrain.WEEK, + "DATETIME({col}, 'start of day', -strftime('%w', {col}) || ' days')", + ), + (TimeGrain.MONTH, "DATETIME({col}, 'start of month')"), + ( + TimeGrain.QUARTER, + "DATETIME({col}, 'start of month', " + "printf('-%d month', (strftime('%m', {col}) - 1) % 3))", + ), + (TimeGrain.YEAR, "DATETIME({col}, 'start of year')"), + ( + TimeGrain.WEEK_ENDING_SATURDAY, + "DATETIME({col}, 'start of day', 'weekday 6')", + ), + ( + TimeGrain.WEEK_ENDING_SUNDAY, + "DATETIME({col}, 'start of day', 'weekday 0')", + ), + ( + TimeGrain.WEEK_STARTING_SUNDAY, + "DATETIME({col}, 'start of day', 'weekday 0', '-7 days')", + ), + ( + TimeGrain.WEEK_STARTING_MONDAY, + "DATETIME({col}, 'start of day', 'weekday 1', '-7 days')", + ), + ], +) +def test_time_grain_expressions( + grain: Optional[TimeGrain], + expected_expression: str, +) -> None: + """Test time grain expressions for MongoDB.""" + from superset.db_engine_specs.mongodb import ( + MongoDBEngineSpec as spec, # noqa: N813 + ) + + # pylint: disable=protected-access + actual = spec._time_grain_expressions.get(grain) + assert actual == expected_expression + + +def test_engine_metadata() -> None: + """Test MongoDB engine specification metadata.""" + from superset.db_engine_specs.mongodb import ( + MongoDBEngineSpec as spec, # noqa: N813 + ) + + assert spec.engine == "mongodb" + assert spec.engine_name == "MongoDB" + assert spec.force_column_alias_quotes is False diff --git a/tests/unit_tests/db_engine_specs/test_redshift.py b/tests/unit_tests/db_engine_specs/test_redshift.py index 77022809075..d733767503f 100644 --- a/tests/unit_tests/db_engine_specs/test_redshift.py +++ b/tests/unit_tests/db_engine_specs/test_redshift.py @@ -20,6 +20,7 @@ from typing import Optional import pytest +from superset.db_engine_specs.redshift import RedshiftEngineSpec from tests.unit_tests.db_engine_specs.utils import assert_convert_dttm from tests.unit_tests.fixtures.common import dttm # noqa: F401 @@ -49,3 +50,32 @@ def test_convert_dttm( ) assert_convert_dttm(spec, target_type, expected_result, dttm) + + +@pytest.mark.parametrize( + "table_name,schema_name,expected_table,expected_schema", + [ + ("BPO_mytest_2", "MySchema", "bpo_mytest_2", "myschema"), + ("MY_TABLE", None, "my_table", None), + ("already_lower", "lower_schema", "already_lower", "lower_schema"), + ], +) +def test_normalize_table_name_for_upload( + table_name: str, + schema_name: Optional[str], + expected_table: str, + expected_schema: Optional[str], +) -> None: + """ + Test that table and schema names are normalized to lowercase for Redshift. + + Redshift folds unquoted identifiers to lowercase, so we need to normalize + table names to ensure consistent behavior when checking table existence + and performing replace operations. + """ + normalized_table, normalized_schema = ( + RedshiftEngineSpec.normalize_table_name_for_upload(table_name, schema_name) + ) + + assert normalized_table == expected_table + assert normalized_schema == expected_schema diff --git a/tests/unit_tests/db_engine_specs/test_trino.py b/tests/unit_tests/db_engine_specs/test_trino.py index 1942b3310e5..dc998d8fdc1 100644 --- a/tests/unit_tests/db_engine_specs/test_trino.py +++ b/tests/unit_tests/db_engine_specs/test_trino.py @@ -1214,3 +1214,174 @@ def test_handle_cursor_only_commits_on_progress_change( # So we expect: 1 (initial) + 1 (0.5) + 1 (1.0) = 3 commits total commit_calls = mock_db.session.commit.call_count assert commit_calls >= 2 # At least initial commit and one progress update + + +@patch("superset.db_engine_specs.presto.PrestoBaseEngineSpec.handle_cursor") +@patch("superset.db_engine_specs.trino.TrinoEngineSpec.cancel_query") +@patch("superset.db_engine_specs.trino.db") +@patch("superset.db_engine_specs.trino.app") +def test_handle_cursor_sets_progress_text_for_planning_state( + mock_app: Mock, + mock_db: Mock, + mock_cancel_query: Mock, + mock_presto_handle_cursor: Mock, + mocker: MockerFixture, +) -> None: + """Test that handle_cursor sets progress_text to 'Scheduled' for PLANNING state.""" + from superset.db_engine_specs.trino import TrinoEngineSpec + from superset.models.sql_lab import Query + + mock_app.config = {"DB_POLL_INTERVAL_SECONDS": {"trino": 0}} + + cursor_mock = mocker.MagicMock(spec=["query_id", "stats", "info_uri"]) + cursor_mock.query_id = "test-query-id" + + call_count = 0 + + def update_stats(*args, **kwargs): + nonlocal call_count + call_count += 1 + if call_count >= 1: + cursor_mock.stats = { + "state": "FINISHED", + "completedSplits": 10, + "totalSplits": 10, + } + + # Start with PLANNING state + cursor_mock.stats = {"state": "PLANNING", "completedSplits": 0, "totalSplits": 10} + + with patch("superset.db_engine_specs.trino.time.sleep", side_effect=update_stats): + query = Query() + query.status = "running" + TrinoEngineSpec.handle_cursor(cursor=cursor_mock, query=query) + + # Check that progress_text was set to "Scheduled" for PLANNING state + assert query.extra.get("progress_text") is not None + + +@patch("superset.db_engine_specs.presto.PrestoBaseEngineSpec.handle_cursor") +@patch("superset.db_engine_specs.trino.TrinoEngineSpec.cancel_query") +@patch("superset.db_engine_specs.trino.db") +@patch("superset.db_engine_specs.trino.app") +def test_handle_cursor_sets_progress_text_for_queued_state( + mock_app: Mock, + mock_db: Mock, + mock_cancel_query: Mock, + mock_presto_handle_cursor: Mock, + mocker: MockerFixture, +) -> None: + """Test that handle_cursor sets progress_text to 'Queued' for QUEUED state.""" + from superset.db_engine_specs.trino import TrinoEngineSpec + from superset.models.sql_lab import Query + + mock_app.config = {"DB_POLL_INTERVAL_SECONDS": {"trino": 0}} + + cursor_mock = mocker.MagicMock(spec=["query_id", "stats", "info_uri"]) + cursor_mock.query_id = "test-query-id" + + call_count = 0 + + def update_stats(*args, **kwargs): + nonlocal call_count + call_count += 1 + if call_count >= 1: + cursor_mock.stats = { + "state": "FINISHED", + "completedSplits": 10, + "totalSplits": 10, + } + + # Start with QUEUED state + cursor_mock.stats = {"state": "QUEUED", "completedSplits": 0, "totalSplits": 0} + + with patch("superset.db_engine_specs.trino.time.sleep", side_effect=update_stats): + query = Query() + query.status = "running" + TrinoEngineSpec.handle_cursor(cursor=cursor_mock, query=query) + + # Check that progress_text was set + assert query.extra.get("progress_text") is not None + + +@patch("superset.db_engine_specs.presto.PrestoBaseEngineSpec.handle_cursor") +@patch("superset.db_engine_specs.trino.TrinoEngineSpec.cancel_query") +@patch("superset.db_engine_specs.trino.db") +@patch("superset.db_engine_specs.trino.app") +def test_handle_cursor_sets_progress_text_to_state_for_unmapped_states( + mock_app: Mock, + mock_db: Mock, + mock_cancel_query: Mock, + mock_presto_handle_cursor: Mock, + mocker: MockerFixture, +) -> None: + """Test that handle_cursor sets progress_text to raw state for unmapped states.""" + from superset.db_engine_specs.trino import TrinoEngineSpec + from superset.models.sql_lab import Query + + mock_app.config = {"DB_POLL_INTERVAL_SECONDS": {"trino": 0}} + + cursor_mock = mocker.MagicMock(spec=["query_id", "stats", "info_uri"]) + cursor_mock.query_id = "test-query-id" + + # Start directly with FINISHED state (not in the mapping) + cursor_mock.stats = {"state": "FINISHED", "completedSplits": 10, "totalSplits": 10} + + query = Query() + query.status = "running" + TrinoEngineSpec.handle_cursor(cursor=cursor_mock, query=query) + + # Check that progress_text was set to the raw state "FINISHED" + # since FINISHED is not in the mapping (only PLANNING and QUEUED are mapped) + assert query.extra.get("progress_text") == "FINISHED" + + +@patch("superset.db_engine_specs.presto.PrestoBaseEngineSpec.handle_cursor") +@patch("superset.db_engine_specs.trino.TrinoEngineSpec.cancel_query") +@patch("superset.db_engine_specs.trino.db") +@patch("superset.db_engine_specs.trino.app") +def test_handle_cursor_commits_on_progress_text_change( + mock_app: Mock, + mock_db: Mock, + mock_cancel_query: Mock, + mock_presto_handle_cursor: Mock, + mocker: MockerFixture, +) -> None: + """Test that handle_cursor commits only when progress_text changes.""" + from superset.db_engine_specs.trino import TrinoEngineSpec + from superset.models.sql_lab import Query + + mock_app.config = {"DB_POLL_INTERVAL_SECONDS": {"trino": 0}} + + cursor_mock = mocker.MagicMock(spec=["query_id", "stats", "info_uri"]) + cursor_mock.query_id = "test-query-id" + + call_count = 0 + + def update_stats(*args, **kwargs): + nonlocal call_count + call_count += 1 + if call_count == 1: + # State changes from QUEUED to RUNNING but progress stays at 0 + cursor_mock.stats = { + "state": "RUNNING", + "completedSplits": 0, + "totalSplits": 10, + } + elif call_count >= 2: + cursor_mock.stats = { + "state": "FINISHED", + "completedSplits": 10, + "totalSplits": 10, + } + + # Start with QUEUED state and 0 progress + cursor_mock.stats = {"state": "QUEUED", "completedSplits": 0, "totalSplits": 10} + + with patch("superset.db_engine_specs.trino.time.sleep", side_effect=update_stats): + query = Query() + query.status = "running" + TrinoEngineSpec.handle_cursor(cursor=cursor_mock, query=query) + + # There should be commits for progress_text changes + assert mock_db.session.commit.call_count >= 2 diff --git a/tests/unit_tests/mcp_service/chart/test_chart_schemas.py b/tests/unit_tests/mcp_service/chart/test_chart_schemas.py index 7292220cd75..5bbae63912b 100644 --- a/tests/unit_tests/mcp_service/chart/test_chart_schemas.py +++ b/tests/unit_tests/mcp_service/chart/test_chart_schemas.py @@ -54,6 +54,59 @@ class TestTableChartConfig: ) assert len(config.columns) == 2 + def test_default_viz_type_is_table(self) -> None: + """Test that default viz_type is 'table'.""" + config = TableChartConfig( + chart_type="table", + columns=[ColumnRef(name="product")], + ) + assert config.viz_type == "table" + + def test_ag_grid_table_viz_type_accepted(self) -> None: + """Test that viz_type='ag-grid-table' is accepted for AG Grid table.""" + config = TableChartConfig( + chart_type="table", + viz_type="ag-grid-table", + columns=[ + ColumnRef(name="product_line"), + ColumnRef(name="sales", aggregate="SUM", label="Total Sales"), + ], + ) + assert config.viz_type == "ag-grid-table" + assert len(config.columns) == 2 + + def test_ag_grid_table_with_all_options(self) -> None: + """Test AG Grid table with filters and sorting.""" + from superset.mcp_service.chart.schemas import FilterConfig + + config = TableChartConfig( + chart_type="table", + viz_type="ag-grid-table", + columns=[ + ColumnRef(name="product_line"), + ColumnRef(name="quantity", aggregate="SUM", label="Total Quantity"), + ColumnRef(name="sales", aggregate="SUM", label="Total Sales"), + ], + filters=[FilterConfig(column="status", op="=", value="active")], + sort_by=["product_line"], + ) + assert config.viz_type == "ag-grid-table" + assert len(config.columns) == 3 + assert config.filters is not None + assert len(config.filters) == 1 + assert config.sort_by == ["product_line"] + + def test_invalid_viz_type_rejected(self) -> None: + """Test that invalid viz_type values are rejected.""" + from pydantic import ValidationError + + with pytest.raises(ValidationError): + TableChartConfig( + chart_type="table", + viz_type="invalid-type", + columns=[ColumnRef(name="product")], + ) + class TestXYChartConfig: """Test XYChartConfig validation.""" diff --git a/tests/unit_tests/mcp_service/chart/test_chart_utils.py b/tests/unit_tests/mcp_service/chart/test_chart_utils.py index 560af4e8632..f2e9d966c89 100644 --- a/tests/unit_tests/mcp_service/chart/test_chart_utils.py +++ b/tests/unit_tests/mcp_service/chart/test_chart_utils.py @@ -152,6 +152,58 @@ class TestMapTableConfig: result = map_table_config(config) assert result["order_by_cols"] == ["product", "revenue"] + def test_map_table_config_ag_grid_table(self) -> None: + """Test table config mapping with AG Grid Interactive Table viz_type""" + config = TableChartConfig( + chart_type="table", + viz_type="ag-grid-table", + columns=[ + ColumnRef(name="product_line"), + ColumnRef(name="sales", aggregate="SUM", label="Total Sales"), + ], + ) + + result = map_table_config(config) + + # AG Grid tables use 'ag-grid-table' viz_type + assert result["viz_type"] == "ag-grid-table" + assert result["query_mode"] == "aggregate" + assert len(result["metrics"]) == 1 + assert result["metrics"][0]["aggregate"] == "SUM" + # Non-aggregated columns should be in groupby + assert "groupby" in result + assert "product_line" in result["groupby"] + + def test_map_table_config_ag_grid_raw_mode(self) -> None: + """Test AG Grid table with raw columns (no aggregates)""" + config = TableChartConfig( + chart_type="table", + viz_type="ag-grid-table", + columns=[ + ColumnRef(name="product_line"), + ColumnRef(name="category"), + ColumnRef(name="region"), + ], + ) + + result = map_table_config(config) + + assert result["viz_type"] == "ag-grid-table" + assert result["query_mode"] == "raw" + assert result["all_columns"] == ["product_line", "category", "region"] + assert "metrics" not in result + + def test_map_table_config_default_viz_type(self) -> None: + """Test that default viz_type is 'table' not 'ag-grid-table'""" + config = TableChartConfig( + chart_type="table", + columns=[ColumnRef(name="product")], + ) + + result = map_table_config(config) + + assert result["viz_type"] == "table" + class TestMapXYConfig: """Test map_xy_config function""" @@ -223,6 +275,82 @@ class TestMapXYConfig: assert result["show_legend"] is False assert result["legend_orientation"] == "top" + def test_map_xy_config_with_time_grain_month(self) -> None: + """Test XY config mapping with monthly time grain""" + config = XYChartConfig( + chart_type="xy", + x=ColumnRef(name="order_date"), + y=[ColumnRef(name="revenue", aggregate="SUM")], + kind="bar", + time_grain="P1M", + ) + + result = map_xy_config(config) + + assert result["viz_type"] == "echarts_timeseries_bar" + assert result["x_axis"] == "order_date" + assert result["time_grain_sqla"] == "P1M" + + def test_map_xy_config_with_time_grain_day(self) -> None: + """Test XY config mapping with daily time grain""" + config = XYChartConfig( + chart_type="xy", + x=ColumnRef(name="created_at"), + y=[ColumnRef(name="count", aggregate="COUNT")], + kind="line", + time_grain="P1D", + ) + + result = map_xy_config(config) + + assert result["viz_type"] == "echarts_timeseries_line" + assert result["x_axis"] == "created_at" + assert result["time_grain_sqla"] == "P1D" + + def test_map_xy_config_with_time_grain_hour(self) -> None: + """Test XY config mapping with hourly time grain""" + config = XYChartConfig( + chart_type="xy", + x=ColumnRef(name="timestamp"), + y=[ColumnRef(name="requests", aggregate="SUM")], + kind="area", + time_grain="PT1H", + ) + + result = map_xy_config(config) + + assert result["time_grain_sqla"] == "PT1H" + + def test_map_xy_config_without_time_grain(self) -> None: + """Test XY config mapping without time grain (should not set time_grain_sqla)""" + config = XYChartConfig( + chart_type="xy", + x=ColumnRef(name="date"), + y=[ColumnRef(name="revenue")], + kind="line", + ) + + result = map_xy_config(config) + + assert "time_grain_sqla" not in result + + def test_map_xy_config_with_time_grain_and_groupby(self) -> None: + """Test XY config mapping with time grain and group by""" + config = XYChartConfig( + chart_type="xy", + x=ColumnRef(name="order_date"), + y=[ColumnRef(name="revenue", aggregate="SUM")], + kind="line", + time_grain="P1W", + group_by=ColumnRef(name="category"), + ) + + result = map_xy_config(config) + + assert result["time_grain_sqla"] == "P1W" + assert result["groupby"] == ["category"] + assert result["x_axis"] == "order_date" + class TestMapConfigToFormData: """Test map_config_to_form_data function""" diff --git a/tests/unit_tests/mcp_service/dataset/tool/test_dataset_tools.py b/tests/unit_tests/mcp_service/dataset/tool/test_dataset_tools.py index 9f16d11b3e8..cde7e130e36 100644 --- a/tests/unit_tests/mcp_service/dataset/tool/test_dataset_tools.py +++ b/tests/unit_tests/mcp_service/dataset/tool/test_dataset_tools.py @@ -1239,6 +1239,59 @@ class TestDatasetDefaultColumnFiltering: assert "metrics" in data["columns_available"] assert "description" in data["columns_available"] + @patch("superset.daos.dataset.DatasetDAO.list") + @pytest.mark.asyncio + async def test_default_columns_filters_actual_response_data( + self, mock_list, mcp_server + ): + """Test that actual dataset items only contain default columns. + + This verifies the fix for the bug where all 40+ columns were returned + with null values even when only default columns were requested. + See: https://github.com/apache/superset/pull/37213 + """ + dataset = create_mock_dataset() + mock_list.return_value = ([dataset], 1) + + async with Client(mcp_server) as client: + # Empty select_columns = use default columns + request = ListDatasetsRequest(page=1, page_size=10, select_columns=[]) + result = await client.call_tool( + "list_datasets", {"request": request.model_dump()} + ) + data = json.loads(result.content[0].text) + + # Get the actual dataset item + assert len(data["datasets"]) == 1 + dataset_item = data["datasets"][0] + + # Verify ONLY default columns are present in the response item + expected_keys = {"id", "table_name", "schema_name", "uuid"} + actual_keys = set(dataset_item.keys()) + + # The response should only contain the default columns, NOT all columns + # with null values (which was the bug) + assert actual_keys == expected_keys, ( + f"Expected only default columns {expected_keys}, " + f"but got {actual_keys}. " + f"Extra columns: {actual_keys - expected_keys}" + ) + + # Verify non-default columns are NOT present (not even with null values) + non_default_columns = [ + "description", + "database_name", + "changed_by", + "changed_on", + "columns", + "metrics", + ] + for col in non_default_columns: + assert col not in dataset_item, ( + f"Non-default column '{col}' should not be in response. " + f"This indicates the column filtering is not working." + ) + class TestDatasetSortableColumns: """Test sortable columns configuration for dataset tools.""" diff --git a/tests/unit_tests/mcp_service/test_mcp_config.py b/tests/unit_tests/mcp_service/test_mcp_config.py index ddec44dffbd..6b466706d07 100644 --- a/tests/unit_tests/mcp_service/test_mcp_config.py +++ b/tests/unit_tests/mcp_service/test_mcp_config.py @@ -66,19 +66,12 @@ def test_init_fastmcp_server_with_default_app_name(): "sys.modules", {"superset.mcp_service.flask_singleton": MagicMock(app=mock_flask_app)}, ): - with patch("superset.mcp_service.app.create_mcp_app") as mock_create: - mock_mcp = MagicMock() - mock_create.return_value = mock_mcp + with patch("superset.mcp_service.app.mcp") as mock_mcp: + init_fastmcp_server() - # Call with custom name to force create_mcp_app path - init_fastmcp_server(name="Custom Name") - - # Verify create_mcp_app was called - assert mock_create.called - # Verify instructions use Superset branding (not Apache Superset) - call_kwargs = mock_create.call_args[1] - assert "Superset MCP" in call_kwargs["instructions"] - assert "Superset dashboards" in call_kwargs["instructions"] + # Verify the global mcp instance was configured with Superset branding + assert "Superset MCP" in mock_mcp._mcp_server.instructions + assert "Superset dashboards" in mock_mcp._mcp_server.instructions def test_init_fastmcp_server_with_custom_app_name(): @@ -93,20 +86,13 @@ def test_init_fastmcp_server_with_custom_app_name(): "sys.modules", {"superset.mcp_service.flask_singleton": MagicMock(app=mock_flask_app)}, ): - with patch("superset.mcp_service.app.create_mcp_app") as mock_create: - mock_mcp = MagicMock() - mock_create.return_value = mock_mcp + with patch("superset.mcp_service.app.mcp") as mock_mcp: + init_fastmcp_server() - # Call with custom name to force create_mcp_app path - init_fastmcp_server(name="Custom Name") - - # Verify create_mcp_app was called - assert mock_create.called # Verify instructions use custom branding - call_kwargs = mock_create.call_args[1] - assert custom_app_name in call_kwargs["instructions"] + assert custom_app_name in mock_mcp._mcp_server.instructions # Should not contain default Apache Superset branding - assert "Apache Superset" not in call_kwargs["instructions"] + assert "Apache Superset" not in mock_mcp._mcp_server.instructions def test_init_fastmcp_server_derives_server_name_from_app_name(): @@ -123,15 +109,44 @@ def test_init_fastmcp_server_derives_server_name_from_app_name(): "sys.modules", {"superset.mcp_service.flask_singleton": MagicMock(app=mock_flask_app)}, ): - with patch("superset.mcp_service.app.create_mcp_app") as mock_create: - mock_mcp = MagicMock() - mock_create.return_value = mock_mcp + with patch("superset.mcp_service.app.mcp") as mock_mcp: + init_fastmcp_server() - # Call without name parameter (should use default derived name) - # Force custom params by passing instructions - init_fastmcp_server(instructions="custom") + # Verify the global mcp instance got the derived name + assert mock_mcp._mcp_server.name == expected_server_name - # Verify create_mcp_app was called with derived name - assert mock_create.called - call_kwargs = mock_create.call_args[1] - assert call_kwargs["name"] == expected_server_name + +def test_init_fastmcp_server_applies_auth_to_global_instance(): + """Test that auth is applied to the global mcp instance, not a new one.""" + mock_flask_app = MagicMock() + mock_flask_app.config.get.return_value = "Superset" + mock_auth = MagicMock() + + with patch.dict( + "sys.modules", + {"superset.mcp_service.flask_singleton": MagicMock(app=mock_flask_app)}, + ): + with patch("superset.mcp_service.app.mcp") as mock_mcp: + result = init_fastmcp_server(auth=mock_auth) + + # Auth should be set on the global instance + assert mock_mcp.auth == mock_auth + # Should return the global instance (not a new one) + assert result is mock_mcp + + +def test_init_fastmcp_server_applies_middleware_to_global_instance(): + """Test that middleware is added to the global mcp instance.""" + mock_flask_app = MagicMock() + mock_flask_app.config.get.return_value = "Superset" + mock_mw = MagicMock() + + with patch.dict( + "sys.modules", + {"superset.mcp_service.flask_singleton": MagicMock(app=mock_flask_app)}, + ): + with patch("superset.mcp_service.app.mcp") as mock_mcp: + init_fastmcp_server(middleware=[mock_mw]) + + # Middleware should be added via add_middleware + mock_mcp.add_middleware.assert_called_once_with(mock_mw) diff --git a/tests/unit_tests/mcp_service/test_mcp_server.py b/tests/unit_tests/mcp_service/test_mcp_server.py new file mode 100644 index 00000000000..0d7922a296a --- /dev/null +++ b/tests/unit_tests/mcp_service/test_mcp_server.py @@ -0,0 +1,126 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. + +"""Tests for MCP server EventStore creation.""" + +from unittest.mock import MagicMock, patch + + +def test_create_event_store_returns_none_when_no_redis_url(): + """EventStore returns None when no Redis URL configured (single-pod mode).""" + config = {"CACHE_REDIS_URL": None} + + from superset.mcp_service.server import create_event_store + + result = create_event_store(config) + + assert result is None + + +def test_create_event_store_returns_none_when_empty_config(): + """EventStore returns None when config has no CACHE_REDIS_URL.""" + config = {} + + from superset.mcp_service.server import create_event_store + + result = create_event_store(config) + + assert result is None + + +def test_create_event_store_creates_event_store_with_redis(): + """EventStore is created with Redis backend when URL is configured.""" + config = { + "CACHE_REDIS_URL": "redis://localhost:6379/0", + "event_store_max_events": 50, + "event_store_ttl": 1800, + } + + mock_redis_store = MagicMock() + mock_event_store = MagicMock() + + with patch( + "superset.mcp_service.server._create_redis_store", + return_value=mock_redis_store, + ) as mock_create_store: + with patch( + "fastmcp.server.event_store.EventStore", + return_value=mock_event_store, + ) as mock_event_store_class: + from superset.mcp_service.server import create_event_store + + result = create_event_store(config) + + # Verify EventStore was created + assert result is mock_event_store + # Verify _create_redis_store was called with prefix wrapper + mock_create_store.assert_called_once_with( + config, prefix="mcp_events_", wrap=True + ) + # Verify EventStore was initialized with correct params + mock_event_store_class.assert_called_once_with( + storage=mock_redis_store, + max_events_per_stream=50, + ttl=1800, + ) + + +def test_create_event_store_uses_default_config_values(): + """EventStore uses default values when not specified in config.""" + config = { + "CACHE_REDIS_URL": "redis://localhost:6379/0", + } + + mock_redis_store = MagicMock() + mock_event_store = MagicMock() + + with patch( + "superset.mcp_service.server._create_redis_store", + return_value=mock_redis_store, + ): + with patch( + "fastmcp.server.event_store.EventStore", + return_value=mock_event_store, + ) as mock_event_store_class: + from superset.mcp_service.server import create_event_store + + result = create_event_store(config) + + assert result is mock_event_store + # Verify defaults are used + mock_event_store_class.assert_called_once_with( + storage=mock_redis_store, + max_events_per_stream=100, # default + ttl=3600, # default + ) + + +def test_create_event_store_returns_none_when_redis_store_fails(): + """EventStore returns None when Redis store creation fails.""" + config = { + "CACHE_REDIS_URL": "redis://localhost:6379/0", + } + + with patch( + "superset.mcp_service.server._create_redis_store", + return_value=None, # Simulates Redis store creation failure + ): + from superset.mcp_service.server import create_event_store + + result = create_event_store(config) + + assert result is None diff --git a/tests/unit_tests/mcp_service/test_mcp_storage.py b/tests/unit_tests/mcp_service/test_mcp_storage.py index b61e99e62bd..c7203619800 100644 --- a/tests/unit_tests/mcp_service/test_mcp_storage.py +++ b/tests/unit_tests/mcp_service/test_mcp_storage.py @@ -68,6 +68,7 @@ def test_get_mcp_store_creates_store_when_enabled(): } mock_redis_store = MagicMock() + mock_redis_client = MagicMock() mock_wrapper_instance = MagicMock() mock_wrapper_class = MagicMock(return_value=mock_wrapper_instance) @@ -84,13 +85,190 @@ def test_get_mcp_store_creates_store_when_enabled(): "key_value.aio.stores.redis.RedisStore", return_value=mock_redis_store, ): - from superset.mcp_service.storage import get_mcp_store + with patch( + "superset.mcp_service.storage.Redis", + return_value=mock_redis_client, + ): + from superset.mcp_service.storage import get_mcp_store - result = get_mcp_store(prefix="test_prefix_") + result = get_mcp_store(prefix="test_prefix_") - # Verify store was created - assert result is mock_wrapper_instance - # Verify wrapper was called with correct args - mock_wrapper_class.assert_called_once_with( - key_value=mock_redis_store, prefix="test_prefix_" - ) + # Verify store was created + assert result is mock_wrapper_instance + # Verify wrapper was called with correct args + mock_wrapper_class.assert_called_once_with( + key_value=mock_redis_store, prefix="test_prefix_" + ) + + +def test_create_redis_store_wrap_false_returns_raw_store(): + """_create_redis_store with wrap=False returns unwrapped RedisStore.""" + store_config = { + "CACHE_REDIS_URL": "redis://localhost:6379/0", + "WRAPPER_TYPE": "key_value.aio.wrappers.prefix_keys.PrefixKeysWrapper", + } + + mock_redis_store = MagicMock() + mock_redis_client = MagicMock() + + with patch( + "key_value.aio.stores.redis.RedisStore", + return_value=mock_redis_store, + ) as mock_redis_store_class: + with patch( + "superset.mcp_service.storage.Redis", + return_value=mock_redis_client, + ) as mock_redis_class: + from superset.mcp_service.storage import _create_redis_store + + result = _create_redis_store(store_config, wrap=False) + + # Verify raw store is returned (not wrapped) + assert result is mock_redis_store + # Verify Redis client was created with correct params + mock_redis_class.assert_called_once() + call_kwargs = mock_redis_class.call_args[1] + assert call_kwargs["host"] == "localhost" + assert call_kwargs["port"] == 6379 + # Verify RedisStore was called with the client + mock_redis_store_class.assert_called_once_with(client=mock_redis_client) + + +def test_create_redis_store_wrap_true_requires_prefix(): + """_create_redis_store with wrap=True requires prefix parameter.""" + store_config = { + "CACHE_REDIS_URL": "redis://localhost:6379/0", + "WRAPPER_TYPE": "key_value.aio.wrappers.prefix_keys.PrefixKeysWrapper", + } + + mock_redis_store = MagicMock() + + with patch( + "key_value.aio.stores.redis.RedisStore", + return_value=mock_redis_store, + ): + from superset.mcp_service.storage import _create_redis_store + + # wrap=True (default) with no prefix should return None + result = _create_redis_store(store_config, prefix=None, wrap=True) + + assert result is None + + +def test_create_redis_store_handles_ssl_url(): + """_create_redis_store handles rediss:// URLs with SSL configuration.""" + store_config = { + "CACHE_REDIS_URL": "rediss://:password@redis.example.com:6380/1", + "WRAPPER_TYPE": "key_value.aio.wrappers.prefix_keys.PrefixKeysWrapper", + } + + mock_redis_store = MagicMock() + mock_redis_client = MagicMock() + + with patch( + "key_value.aio.stores.redis.RedisStore", + return_value=mock_redis_store, + ): + with patch( + "superset.mcp_service.storage.Redis", + return_value=mock_redis_client, + ) as mock_redis_class: + from superset.mcp_service.storage import _create_redis_store + + result = _create_redis_store(store_config, wrap=False) + + # Verify store was created + assert result is mock_redis_store + # Verify Redis client was created with SSL params + call_kwargs = mock_redis_class.call_args[1] + assert call_kwargs["ssl"] is True + assert call_kwargs["ssl_cert_reqs"] == "none" + assert call_kwargs["host"] == "redis.example.com" + assert call_kwargs["port"] == 6380 + assert call_kwargs["db"] == 1 + + +def test_create_redis_store_non_ssl_url_no_ssl_param(): + """_create_redis_store with redis:// URL doesn't pass SSL params.""" + store_config = { + "CACHE_REDIS_URL": "redis://localhost:6379/0", + } + + mock_redis_store = MagicMock() + mock_redis_client = MagicMock() + + with patch( + "key_value.aio.stores.redis.RedisStore", + return_value=mock_redis_store, + ): + with patch( + "superset.mcp_service.storage.Redis", + return_value=mock_redis_client, + ) as mock_redis_class: + from superset.mcp_service.storage import _create_redis_store + + result = _create_redis_store(store_config, wrap=False) + + assert result is mock_redis_store + # Verify SSL params were NOT passed for non-SSL URL + call_kwargs = mock_redis_class.call_args[1] + assert "ssl" not in call_kwargs + assert "ssl_cert_reqs" not in call_kwargs + + +def test_create_redis_store_handles_url_with_username_and_password(): + """_create_redis_store properly handles URL with username and password.""" + test_password = "mypassword" # noqa: S105 + store_config = { + "CACHE_REDIS_URL": f"redis://myuser:{test_password}@redis.example.com:6379/0", + } + + mock_redis_store = MagicMock() + mock_redis_client = MagicMock() + + with patch( + "key_value.aio.stores.redis.RedisStore", + return_value=mock_redis_store, + ): + with patch( + "superset.mcp_service.storage.Redis", + return_value=mock_redis_client, + ) as mock_redis_class: + from superset.mcp_service.storage import _create_redis_store + + result = _create_redis_store(store_config, wrap=False) + + assert result is mock_redis_store + # Verify Redis client was created with password from URL + call_kwargs = mock_redis_class.call_args[1] + assert call_kwargs["host"] == "redis.example.com" + assert call_kwargs["password"] == test_password + + +def test_create_redis_store_handles_url_with_only_username(): + """_create_redis_store handles URL with username but no password.""" + store_config = { + "CACHE_REDIS_URL": "redis://myuser@redis.example.com:6379/0", + } + + mock_redis_store = MagicMock() + mock_redis_client = MagicMock() + + with patch( + "key_value.aio.stores.redis.RedisStore", + return_value=mock_redis_store, + ): + with patch( + "superset.mcp_service.storage.Redis", + return_value=mock_redis_client, + ) as mock_redis_class: + from superset.mcp_service.storage import _create_redis_store + + result = _create_redis_store(store_config, wrap=False) + + assert result is mock_redis_store + # Verify Redis client was created with correct params + call_kwargs = mock_redis_class.call_args[1] + assert call_kwargs["host"] == "redis.example.com" + # No password in URL means password should be None + assert call_kwargs["password"] is None diff --git a/tests/unit_tests/models/core_test.py b/tests/unit_tests/models/core_test.py index 2667d359d2e..7d7aa96ea19 100644 --- a/tests/unit_tests/models/core_test.py +++ b/tests/unit_tests/models/core_test.py @@ -410,6 +410,121 @@ def test_get_all_catalog_names_needs_oauth2(mocker: MockerFixture) -> None: assert excinfo.value.error.error_type == SupersetErrorType.OAUTH2_REDIRECT +def test_get_all_table_names_in_schema_needs_oauth2(mocker: MockerFixture) -> None: + """ + Test the `get_all_table_names_in_schema` method when OAuth2 is needed. + """ + database = Database( + database_name="db", + sqlalchemy_uri="snowflake://:@abcd1234.snowflakecomputing.com/db", + encrypted_extra=json.dumps(oauth2_client_info), + ) + + class DriverSpecificError(Exception): + """ + A custom exception that is raised by the Snowflake driver. + """ + + mocker.patch.object( + database.db_engine_spec, + "oauth2_exception", + DriverSpecificError, + ) + mocker.patch.object( + database.db_engine_spec, + "get_table_names", + side_effect=DriverSpecificError("User needs to authenticate"), + ) + mocker.patch.object(database, "get_inspector") + user = mocker.MagicMock() + user.id = 42 + mocker.patch("superset.db_engine_specs.base.g", user=user) + + with pytest.raises(OAuth2RedirectError) as excinfo: + database.get_all_table_names_in_schema(catalog=None, schema="public") + + assert excinfo.value.message == "You don't have permission to access the data." + assert excinfo.value.error.error_type == SupersetErrorType.OAUTH2_REDIRECT + + +def test_get_all_view_names_in_schema_needs_oauth2(mocker: MockerFixture) -> None: + """ + Test the `get_all_view_names_in_schema` method when OAuth2 is needed. + """ + database = Database( + database_name="db", + sqlalchemy_uri="snowflake://:@abcd1234.snowflakecomputing.com/db", + encrypted_extra=json.dumps(oauth2_client_info), + ) + + class DriverSpecificError(Exception): + """ + A custom exception that is raised by the Snowflake driver. + """ + + mocker.patch.object( + database.db_engine_spec, + "oauth2_exception", + DriverSpecificError, + ) + mocker.patch.object( + database.db_engine_spec, + "get_view_names", + side_effect=DriverSpecificError("User needs to authenticate"), + ) + mocker.patch.object(database, "get_inspector") + user = mocker.MagicMock() + user.id = 42 + mocker.patch("superset.db_engine_specs.base.g", user=user) + + with pytest.raises(OAuth2RedirectError) as excinfo: + database.get_all_view_names_in_schema(catalog=None, schema="public") + + assert excinfo.value.message == "You don't have permission to access the data." + assert excinfo.value.error.error_type == SupersetErrorType.OAUTH2_REDIRECT + + +def test_get_all_materialized_view_names_in_schema_needs_oauth2( + mocker: MockerFixture, +) -> None: + """ + Test the `get_all_materialized_view_names_in_schema` method when OAuth2 is needed. + """ + database = Database( + database_name="db", + sqlalchemy_uri="snowflake://:@abcd1234.snowflakecomputing.com/db", + encrypted_extra=json.dumps(oauth2_client_info), + ) + + class DriverSpecificError(Exception): + """ + A custom exception that is raised by the Snowflake driver. + """ + + mocker.patch.object( + database.db_engine_spec, + "oauth2_exception", + DriverSpecificError, + ) + mocker.patch.object( + database.db_engine_spec, + "get_materialized_view_names", + side_effect=DriverSpecificError("User needs to authenticate"), + ) + mocker.patch.object(database, "get_inspector") + user = mocker.MagicMock() + user.id = 42 + mocker.patch("superset.db_engine_specs.base.g", user=user) + + with pytest.raises(OAuth2RedirectError) as excinfo: + database.get_all_materialized_view_names_in_schema( + catalog=None, schema="public" + ) + + assert excinfo.value.message == "You don't have permission to access the data." + assert excinfo.value.error.error_type == SupersetErrorType.OAUTH2_REDIRECT + + def test_get_sqla_engine(mocker: MockerFixture) -> None: """ Test `_get_sqla_engine`. @@ -545,6 +660,34 @@ def test_get_oauth2_config(app_context: None) -> None: assert database.get_oauth2_config() is None + database.encrypted_extra = json.dumps(oauth2_client_info) + assert database.get_oauth2_config() == { + "id": "my_client_id", + "secret": "my_client_secret", + "authorization_request_uri": "https://abcd1234.snowflakecomputing.com/oauth/authorize", + "token_request_uri": "https://abcd1234.snowflakecomputing.com/oauth/token-request", + "scope": "refresh_token session:role:USERADMIN", + "redirect_uri": "http://example.com/api/v1/database/oauth2/", + "request_content_type": "data", # Default value from BaseEngineSpec + } + + +def test_get_oauth2_config_token_request_type_from_db_engine_specs( + mocker: MockerFixture, app_context: None +) -> None: + """ + Test that DB Engine Spec overrides for ``oauth2_token_request_type`` are respected. + """ + database = Database( + database_name="db", + sqlalchemy_uri="postgresql://user:password@host:5432/examples", + ) + mocker.patch.object( + database.db_engine_spec, + "oauth2_token_request_type", + "json", + ) + database.encrypted_extra = json.dumps(oauth2_client_info) assert database.get_oauth2_config() == { "id": "my_client_id", @@ -557,6 +700,59 @@ def test_get_oauth2_config(app_context: None) -> None: } +def test_get_oauth2_config_custom_token_request_type_extra(app_context: None) -> None: + """ + Test passing a custom ``token_request_type`` via ``encrypted_extra`` + takes precedence. + """ + database = Database( + database_name="db", + sqlalchemy_uri="postgresql://user:password@host:5432/examples", + ) + custom_oauth2_client_info = { + "oauth2_client_info": { + **oauth2_client_info["oauth2_client_info"], + "request_content_type": "json", + } + } + + database.encrypted_extra = json.dumps(custom_oauth2_client_info) + assert database.get_oauth2_config() == { + "id": "my_client_id", + "secret": "my_client_secret", + "authorization_request_uri": "https://abcd1234.snowflakecomputing.com/oauth/authorize", + "token_request_uri": "https://abcd1234.snowflakecomputing.com/oauth/token-request", + "scope": "refresh_token session:role:USERADMIN", + "redirect_uri": "http://example.com/api/v1/database/oauth2/", + "request_content_type": "json", + } + + +def test_get_oauth2_config_redirect_uri_from_config( + mocker: MockerFixture, + app_context: None, +) -> None: + """ + Test that ``DATABASE_OAUTH2_REDIRECT_URI`` config takes precedence over + url_for default. + """ + custom_redirect_uri = "https://custom.example.com/oauth/callback" + mocker.patch.dict( + "superset.utils.oauth2.app.config", + {"DATABASE_OAUTH2_REDIRECT_URI": custom_redirect_uri}, + ) + database = Database( + database_name="db", + sqlalchemy_uri="postgresql://user:password@host:5432/examples", + ) + database.encrypted_extra = json.dumps(oauth2_client_info) + + config = database.get_oauth2_config() + + assert config is not None + assert config["redirect_uri"] == custom_redirect_uri + + def test_raw_connection_oauth_engine(mocker: MockerFixture) -> None: """ Test that we can start OAuth2 from `raw_connection()` errors. diff --git a/tests/unit_tests/sql/transpile_to_dialect_test.py b/tests/unit_tests/sql/transpile_to_dialect_test.py index 1327b09009c..5a11e501fad 100644 --- a/tests/unit_tests/sql/transpile_to_dialect_test.py +++ b/tests/unit_tests/sql/transpile_to_dialect_test.py @@ -345,3 +345,54 @@ def test_sqlglot_generation_error_raises_exception() -> None: match="Cannot transpile SQL to postgresql", ): transpile_to_dialect("name = 'test'", "postgresql") + + +# Tests for source_engine parameter +@pytest.mark.parametrize( + ("sql", "source_engine", "target_engine", "expected"), + [ + # PostgreSQL to MySQL - should convert :: casting to CAST() + ( + "SELECT created_at::DATE FROM orders", + "postgresql", + "mysql", + "SELECT CAST(created_at AS DATE) FROM orders", + ), + # Same dialect - should preserve SQL + ( + "SELECT * FROM orders", + "postgresql", + "postgresql", + "SELECT * FROM orders", + ), + # PostgreSQL to DuckDB - DuckDB supports similar syntax (uppercases date part) + ( + "SELECT DATE_TRUNC('month', ts) FROM orders", + "postgresql", + "duckdb", + "SELECT DATE_TRUNC('MONTH', ts) FROM orders", + ), + ], +) +def test_transpile_with_source_engine( + sql: str, source_engine: str, target_engine: str, expected: str +) -> None: + """Test transpilation with explicit source engine.""" + result = transpile_to_dialect(sql, target_engine, source_engine) + assert result == expected + + +def test_transpile_source_engine_none_uses_generic() -> None: + """Test that source_engine=None uses generic dialect (backward compatible).""" + # Simple SQL that doesn't require dialect-specific parsing + result = transpile_to_dialect("SELECT * FROM orders", "postgresql", None) + assert result == "SELECT * FROM orders" + + +def test_transpile_unknown_source_engine_uses_generic() -> None: + """Test that unknown source_engine falls back to generic dialect.""" + # Unknown engine should be treated as None (generic) + result = transpile_to_dialect( + "SELECT * FROM orders", "postgresql", "unknown_engine" + ) + assert result == "SELECT * FROM orders" diff --git a/tests/unit_tests/utils/test_cache_manager.py b/tests/unit_tests/utils/test_cache_manager.py new file mode 100644 index 00000000000..b7b10e4506e --- /dev/null +++ b/tests/unit_tests/utils/test_cache_manager.py @@ -0,0 +1,171 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +import hashlib +from unittest.mock import MagicMock, patch + +import pytest + +from superset.utils.cache_manager import ( + configurable_hash_method, + ConfigurableHashMethod, + SupersetCache, +) + + +def test_configurable_hash_method_uses_sha256(): + """Test ConfigurableHashMethod uses sha256 when configured.""" + mock_app = MagicMock() + mock_app.config = {"HASH_ALGORITHM": "sha256"} + + with patch("superset.utils.cache_manager.current_app", mock_app): + hash_obj = configurable_hash_method(b"test") + # Verify it returns a sha256 hash object + assert hash_obj.hexdigest() == hashlib.sha256(b"test").hexdigest() + + +def test_configurable_hash_method_uses_md5(): + """Test ConfigurableHashMethod uses md5 when configured.""" + mock_app = MagicMock() + mock_app.config = {"HASH_ALGORITHM": "md5"} + + with patch("superset.utils.cache_manager.current_app", mock_app): + hash_obj = configurable_hash_method(b"test") + # Verify it returns a md5 hash object + assert hash_obj.hexdigest() == hashlib.md5(b"test").hexdigest() # noqa: S324 + + +def test_configurable_hash_method_empty_data(): + """Test ConfigurableHashMethod with empty data.""" + mock_app = MagicMock() + mock_app.config = {"HASH_ALGORITHM": "sha256"} + + with patch("superset.utils.cache_manager.current_app", mock_app): + hash_obj = configurable_hash_method() + assert hash_obj.hexdigest() == hashlib.sha256(b"").hexdigest() + + +def test_configurable_hash_method_is_callable(): + """Test that ConfigurableHashMethod instance is callable.""" + method = ConfigurableHashMethod() + assert callable(method) + + +def test_superset_cache_memoize_uses_configurable_hash(): + """Test that SupersetCache.memoize uses configurable_hash_method by default.""" + cache = SupersetCache() + + with patch.object( + cache.__class__.__bases__[0], "memoize", return_value=lambda f: f + ) as mock_memoize: + cache.memoize(timeout=300) + + mock_memoize.assert_called_once() + call_kwargs = mock_memoize.call_args[1] + assert call_kwargs["hash_method"] is configurable_hash_method + + +def test_superset_cache_memoize_allows_explicit_hash_method(): + """Test that SupersetCache.memoize allows explicit hash_method override.""" + cache = SupersetCache() + + with patch.object( + cache.__class__.__bases__[0], "memoize", return_value=lambda f: f + ) as mock_memoize: + cache.memoize(timeout=300, hash_method=hashlib.md5) + + mock_memoize.assert_called_once() + call_kwargs = mock_memoize.call_args[1] + assert call_kwargs["hash_method"] == hashlib.md5 + + +def test_superset_cache_cached_uses_configurable_hash(): + """Test that SupersetCache.cached uses configurable_hash_method by default.""" + cache = SupersetCache() + + with patch.object( + cache.__class__.__bases__[0], "cached", return_value=lambda f: f + ) as mock_cached: + cache.cached(timeout=300) + + mock_cached.assert_called_once() + call_kwargs = mock_cached.call_args[1] + assert call_kwargs["hash_method"] is configurable_hash_method + + +def test_superset_cache_cached_allows_explicit_hash_method(): + """Test that SupersetCache.cached allows explicit hash_method override.""" + cache = SupersetCache() + + with patch.object( + cache.__class__.__bases__[0], "cached", return_value=lambda f: f + ) as mock_cached: + cache.cached(timeout=300, hash_method=hashlib.md5) + + mock_cached.assert_called_once() + call_kwargs = mock_cached.call_args[1] + assert call_kwargs["hash_method"] == hashlib.md5 + + +def test_superset_cache_memoize_make_cache_key_uses_configurable_hash(): + """Test _memoize_make_cache_key uses configurable_hash_method by default.""" + cache = SupersetCache() + + with patch.object( + cache.__class__.__bases__[0], + "_memoize_make_cache_key", + return_value=lambda *args, **kwargs: "cache_key", + ) as mock_make_key: + cache._memoize_make_cache_key(make_name=None, timeout=300) + + mock_make_key.assert_called_once() + call_kwargs = mock_make_key.call_args[1] + assert call_kwargs["hash_method"] is configurable_hash_method + + +def test_superset_cache_memoize_make_cache_key_allows_explicit_hash(): + """Test _memoize_make_cache_key allows explicit hash_method override.""" + cache = SupersetCache() + + with patch.object( + cache.__class__.__bases__[0], + "_memoize_make_cache_key", + return_value=lambda *args, **kwargs: "cache_key", + ) as mock_make_key: + cache._memoize_make_cache_key( + make_name=None, timeout=300, hash_method=hashlib.md5 + ) + + mock_make_key.assert_called_once() + call_kwargs = mock_make_key.call_args[1] + assert call_kwargs["hash_method"] == hashlib.md5 + + +@pytest.mark.parametrize( + "algorithm,expected_digest", + [ + ("sha256", hashlib.sha256(b"test_data").hexdigest()), + ("md5", hashlib.md5(b"test_data").hexdigest()), # noqa: S324 + ], +) +def test_configurable_hash_method_parametrized(algorithm, expected_digest): + """Parametrized test for ConfigurableHashMethod with different algorithms.""" + mock_app = MagicMock() + mock_app.config = {"HASH_ALGORITHM": algorithm} + + with patch("superset.utils.cache_manager.current_app", mock_app): + hash_obj = configurable_hash_method(b"test_data") + assert hash_obj.hexdigest() == expected_digest diff --git a/tests/unit_tests/views/test_base_theme_helpers.py b/tests/unit_tests/views/test_base_theme_helpers.py index 4f29480afdc..3b3ac972bbe 100644 --- a/tests/unit_tests/views/test_base_theme_helpers.py +++ b/tests/unit_tests/views/test_base_theme_helpers.py @@ -530,3 +530,305 @@ class TestGetThemeBootstrapData: assert result["theme"]["enableUiThemeAdministration"] is False assert result["theme"]["default"] == {} assert result["theme"]["dark"] == {} + + +class TestBrandAppNameFallback: + """Test brandAppName fallback mechanism for APP_NAME migration (issue #34865)""" + + @patch("superset.views.base.get_spa_payload") + @patch("superset.views.base.app") + def test_brandappname_uses_theme_value_when_set(self, mock_app, mock_payload): + """Test that explicit brandAppName in theme takes precedence""" + from superset.views.base import get_spa_template_context + + # Use a plain dict for config to mirror Flask's config mapping behavior + mock_app.config = {"APP_NAME": "Fallback App Name"} + + # Mock payload with theme data that has custom brandAppName + mock_payload.return_value = { + "common": { + "theme": { + "default": { + "token": { + "brandAppName": "My Custom App", + "brandLogoAlt": "Logo Alt", + } + } + } + } + } + + result = get_spa_template_context("app") + + # Should use the theme's brandAppName + assert result["default_title"] == "My Custom App" + # Theme tokens should have brandAppName + theme_tokens = result["theme_tokens"] + assert theme_tokens["brandAppName"] == "My Custom App" + + @patch("superset.views.base.get_spa_payload") + @patch("superset.views.base.app") + def test_brandappname_falls_back_to_app_name_config(self, mock_app, mock_payload): + """Test fallback to APP_NAME config when brandAppName not in theme""" + from superset.views.base import get_spa_template_context + + mock_app.config = MagicMock() + mock_app.config.get.side_effect = lambda k, d=None: { + "APP_NAME": "My Test Analytics Platform", + }.get(k, d) + + # Mock payload with default "Superset" brandAppName + mock_payload.return_value = { + "common": { + "theme": { + "default": { + "token": { + "brandAppName": "Superset", # Default value + "brandLogoAlt": "Apache Superset", + } + } + } + } + } + + result = get_spa_template_context("app") + + # Should fall back to APP_NAME config + assert result["default_title"] == "My Test Analytics Platform" + # Theme tokens should be updated with APP_NAME value + theme_tokens = result["theme_tokens"] + assert theme_tokens["brandAppName"] == "My Test Analytics Platform" + + @patch("superset.views.base.get_spa_payload") + @patch("superset.views.base.app") + def test_brandappname_uses_superset_default_when_nothing_set( + self, mock_app, mock_payload + ): + """Test fallback to 'Superset' when neither is customized""" + from superset.views.base import get_spa_template_context + + mock_app.config = MagicMock() + mock_app.config.get.side_effect = lambda k, d=None: { + "APP_NAME": "Superset", # Default value + }.get(k, d) + + # Mock payload with default "Superset" brandAppName + mock_payload.return_value = { + "common": { + "theme": { + "default": { + "token": { + "brandAppName": "Superset", # Default value + "brandLogoAlt": "Apache Superset", + } + } + } + } + } + + result = get_spa_template_context("app") + + # Should use default "Superset" + assert result["default_title"] == "Superset" + # Theme tokens should keep "Superset" + theme_tokens = result["theme_tokens"] + assert theme_tokens["brandAppName"] == "Superset" + + @patch("superset.views.base.get_spa_payload") + @patch("superset.views.base.app") + def test_brandappname_empty_string_falls_back(self, mock_app, mock_payload): + """Test that empty string brandAppName triggers fallback""" + from superset.views.base import get_spa_template_context + + mock_app.config = MagicMock() + mock_app.config.get.side_effect = lambda k, d=None: { + "APP_NAME": "Custom App", + }.get(k, d) + + # Mock payload with empty brandAppName + mock_payload.return_value = { + "common": { + "theme": { + "default": { + "token": { + "brandAppName": "", # Empty string + "brandLogoAlt": "Logo", + } + } + } + } + } + + result = get_spa_template_context("app") + + # Should fall back to APP_NAME + assert result["default_title"] == "Custom App" + theme_tokens = result["theme_tokens"] + assert theme_tokens["brandAppName"] == "Custom App" + + @patch("superset.views.base.get_spa_payload") + @patch("superset.views.base.app") + def test_brandappname_none_falls_back(self, mock_app, mock_payload): + """Test that missing brandAppName triggers fallback""" + from superset.views.base import get_spa_template_context + + mock_app.config = MagicMock() + mock_app.config.get.side_effect = lambda k, d=None: { + "APP_NAME": "Analytics Dashboard", + }.get(k, d) + + # Mock payload without brandAppName + mock_payload.return_value = { + "common": {"theme": {"default": {"token": {"brandLogoAlt": "Logo"}}}} + } + + result = get_spa_template_context("app") + + # Should fall back to APP_NAME + assert result["default_title"] == "Analytics Dashboard" + theme_tokens = result["theme_tokens"] + assert theme_tokens["brandAppName"] == "Analytics Dashboard" + + @patch("superset.views.base.get_spa_payload") + @patch("superset.views.base.app") + def test_brandappname_updates_both_default_and_dark_themes( + self, mock_app, mock_payload + ): + """Test that brandAppName fallback applies to both default and dark themes""" + from superset.views.base import get_spa_template_context + + mock_app.config = MagicMock() + mock_app.config.get.side_effect = lambda k, d=None: { + "APP_NAME": "Multi Theme App", + }.get(k, d) + + # Mock payload with both themes missing brandAppName + mock_payload.return_value = { + "common": { + "theme": { + "default": { + "token": { + "brandAppName": "Superset", # Default value + "colorPrimary": "#111", + } + }, + "dark": { + "token": { + # Missing brandAppName + "colorPrimary": "#222", + } + }, + } + } + } + + result = get_spa_template_context("app") + + # Should update both themes + assert result["default_title"] == "Multi Theme App" + # Verify default theme was updated + theme_tokens = result["theme_tokens"] + assert theme_tokens["brandAppName"] == "Multi Theme App" + assert theme_tokens["colorPrimary"] == "#111" # Preserved + + @patch("superset.views.base.get_spa_payload") + @patch("superset.views.base.app") + def test_brandappname_does_not_mutate_cached_payload(self, mock_app, mock_payload): + """Test that brandAppName fallback doesn't mutate the cached payload""" + from superset.views.base import get_spa_template_context + + mock_app.config = MagicMock() + mock_app.config.get.side_effect = lambda k, d=None: { + "APP_NAME": "Test App", + }.get(k, d) + + # Create a payload that simulates cached data + original_theme_data = { + "default": { + "token": { + "brandAppName": "Superset", + "colorPrimary": "#333", + } + } + } + + mock_payload.return_value = {"common": {"theme": original_theme_data}} + + # Call get_spa_template_context + result = get_spa_template_context("app") + + # Verify the function result has the updated brandAppName + assert result["default_title"] == "Test App" + theme_tokens = result["theme_tokens"] + assert theme_tokens["brandAppName"] == "Test App" + + # Verify the original mock payload structure wasn't mutated + # (the function should deep copy before mutating) + # Note: We can't easily test the cached payload immutability + # without more complex mocking, but we've verified the result is correct + assert result["default_title"] == "Test App" + + @patch("superset.views.base.get_spa_payload") + @patch("superset.views.base.app") + def test_brandappname_handles_empty_theme_config(self, mock_app, mock_payload): + """Test that empty theme configs are skipped gracefully""" + from superset.views.base import get_spa_template_context + + mock_app.config = {"APP_NAME": "Test App"} + + # Mock payload with empty dark theme + mock_payload.return_value = { + "common": { + "theme": { + "default": {"token": {"brandAppName": "Superset"}}, + "dark": {}, # Empty theme config + } + } + } + + result = get_spa_template_context("app") + + # Should handle empty theme gracefully and still update default + assert result["default_title"] == "Test App" + + @patch("superset.views.base.get_spa_payload") + @patch("superset.views.base.app") + def test_brandappname_creates_token_dict_when_missing(self, mock_app, mock_payload): + """Test that token dict is created when missing from theme config""" + from superset.views.base import get_spa_template_context + + mock_app.config = {"APP_NAME": "Token Test App"} + + # Mock payload with theme missing token dict + mock_payload.return_value = { + "common": { + "theme": { + "default": {"algorithm": "default"}, # No token dict + "dark": {"algorithm": "dark"}, # No token dict + } + } + } + + result = get_spa_template_context("app") + + # Should create token dict and set brandAppName + assert result["default_title"] == "Token Test App" + assert result["theme_tokens"]["brandAppName"] == "Token Test App" + + @patch("superset.views.base.get_spa_payload") + @patch("superset.views.base.app") + def test_brandappname_handles_missing_common_in_payload( + self, mock_app, mock_payload + ): + """Test handling when common dict is missing from payload""" + from superset.views.base import get_spa_template_context + + mock_app.config = {"APP_NAME": "Superset"} + + # Mock payload without common dict + mock_payload.return_value = {} + + result = get_spa_template_context("app") + + # Should handle gracefully and use default title + assert result["default_title"] == "Superset"