https://6a024bf2a7e6a60008bd1284--thriving-cassata-78ae72.netlify.app/docs/developers/Recent content in Developers onHugo -- gohugo.iohttps://6a024bf2a7e6a60008bd1284--thriving-cassata-78ae72.netlify.app/docs/0.1.0/developers/running-dj-locally/Mon, 01 Jan 0001 00:00:00 +0000https://6a024bf2a7e6a60008bd1284--thriving-cassata-78ae72.netlify.app/docs/0.1.0/developers/running-dj-locally/Using Docker Compose # The easiest way to try out DataJunction locally is to use the Docker Compose setup. This setup will launch and connect the primary DJ backend, the DJ UI, a reflection service, a query service, and a JupyterLab instance with a few example notebooks. Clone the DJ repository. git clone git@github.com:DataJunction/dj.git Change into the dj/ directory and start the Docker Compose environment with the demo profile. cd dj/ docker compose --profile demo up Check that the following services are accessible: 👉 The DJ UI at http://localhost:3000, with some example data models pre-loaded.https://6a024bf2a7e6a60008bd1284--thriving-cassata-78ae72.netlify.app/docs/0.1.0/developers/clients/Mon, 01 Jan 0001 00:00:00 +0000https://6a024bf2a7e6a60008bd1284--thriving-cassata-78ae72.netlify.app/docs/0.1.0/developers/clients/Python # The DataJunction python client can be installed using pip. See the PyPI client library. pip install datajunction To use the read-only client: from datajunction import DJClient dj = DJClient("http://localhost:8000") To use the full client: from datajunction import DJBuilder dj = DJBuilder("http://localhost:8000") Javascript # The DataJunction javascript client can be installed using npm for use in a node project or using the UNPKG CDN for client-side use. CommonJS npm install datajunction const { DJClient } = require('datajunction') const dj = new DJClient('http://localhost:8000') dj.https://6a024bf2a7e6a60008bd1284--thriving-cassata-78ae72.netlify.app/docs/0.1.0/developers/authentication/Mon, 01 Jan 0001 00:00:00 +0000https://6a024bf2a7e6a60008bd1284--thriving-cassata-78ae72.netlify.app/docs/0.1.0/developers/authentication/The open-source DJ project comes with support for multiple forms of authentication. Which forms of authentication are enabled is determined by the server configuration. OAuth Provider Server Configuration Variables Basic SECRET GitHub SECRET, GITHUB_OAUTH_CLIENT_ID, GITHUB_OAUTH_CLIENT_SECRET Basic # To enable basic authentication, you simply need to set SECRET in the server configuration. The value must be a 16-bit string. The secret will be used for hashing and verifying user passwords as well as encrypting and decrypting JWT cookies.https://6a024bf2a7e6a60008bd1284--thriving-cassata-78ae72.netlify.app/docs/0.1.0/developers/how-metric-requests-are-converted-to-sql/Mon, 01 Jan 0001 00:00:00 +0000https://6a024bf2a7e6a60008bd1284--thriving-cassata-78ae72.netlify.app/docs/0.1.0/developers/how-metric-requests-are-converted-to-sql/How Metric Requests are Converted to SQL # This document explains how DataJunction converts metric requests into SQL queries. Understanding this flow is essential for: Debugging generated SQL Optimizing metric definitions Contributing to the SQL generation code For background on metric decomposition (the theory behind breaking metrics into pre-aggregatable components), see Metric Decomposition. Overview Architecture # User Request (metrics + dimensions + filters) | v +-------------------------------------------------------------+ | DECOMPOSITION PHASE | | - Load metric nodes and their dependencies | | - Extract components from base metrics | | - Build parent_map for derived metric relationships | | - Identify window metrics (LAG/LEAD/etc.https://6a024bf2a7e6a60008bd1284--thriving-cassata-78ae72.netlify.app/docs/0.1.0/developers/docs-development/Mon, 01 Jan 0001 00:00:00 +0000https://6a024bf2a7e6a60008bd1284--thriving-cassata-78ae72.netlify.app/docs/0.1.0/developers/docs-development/The DJ project uses the Hugo framework for building the docs site and all of the pages are defined as markdown files. The deployed docs site is actually a combination of multiple sites for different versions of DJ. This page will help to understand how to modify, locally test, and deploy DJ docs. Running the Docs Site Locally # Clone the DJ repo locally. git clone https://github.com/datajunction/dj Clone the hugo-doks theme submodule.https://6a024bf2a7e6a60008bd1284--thriving-cassata-78ae72.netlify.app/docs/0.1.0/developers/releasing-new-version/Mon, 01 Jan 0001 00:00:00 +0000https://6a024bf2a7e6a60008bd1284--thriving-cassata-78ae72.netlify.app/docs/0.1.0/developers/releasing-new-version/DataJunction project publishes all of its backend services and the Python client library to PyPI: datajunction-clients/python datajunction-query datajunction-server datajunction-reflection Javascript client and the UI component go to NPM: datajunction-clients/javascript datajunction-ui JAVA client (TODO): datajunction-clients/java Documentation (TODO). docs Dev Releases # If you’d like make a dev release of any DataJunction component switch to a corresponding component directory and run: make dev-release Look for the version and a target release url in the output.https://6a024bf2a7e6a60008bd1284--thriving-cassata-78ae72.netlify.app/docs/0.1.0/developers/dj-server-v0.0.1a44/Mon, 01 Jan 0001 00:00:00 +0000https://6a024bf2a7e6a60008bd1284--thriving-cassata-78ae72.netlify.app/docs/0.1.0/developers/dj-server-v0.0.1a44/Scroll down for code samples, example requests and responses. Select a language for code samples from the tabs above or the mobile navigation menu. A DataJunction metrics layer License: MIT License Authentication # HTTP Authentication, scheme: bearer Handle Http Get # GET /graphql Example responses 200 Response null Status Meaning Description Schema 200 OK The GraphiQL integrated development environment. Inline 404 Not Found Not found if GraphiQL or query via GET are not enabled.