{
  "source_file": "0930",
  "source_platform": "Medium",
  "author": "Naser Tamimi",
  "title_listed": "Collaboration-Friendly SQL Queries",
  "keywords": "",
  "domain": "数据处理",
  "content_type": "深度技术解析",
  "is_paid_flag": "否",
  "url": "https://towardsdatascience.com/collaboration-friendly-sql-queries-ee7e14547a61/",
  "publish_date": "2021-11-08",
  "corpus_stage": "",
  "notes": "",
  "id": "d8ec7b320c8b",
  "collected_at": "2026-10-02T05:16:45",
  "title": "Collaboration-Friendly SQL Queries | Towards Data Science",
  "body_markdown": "![Revisit consent button](../images/body-df29beacd7496220cc94.svg)\nWe value your privacy\nWe use cookies to enhance your browsing experience, serve personalised ads or content, and analyse our traffic. By clicking \"Accept All\", you consent to our use of cookies.\nCustomise Reject All Accept All\nCustomise Consent Preferences ![](../images/body-2159bb67f3de8ad870eb.svg)\nWe use cookies to help you navigate efficiently and perform certain functions. You will find detailed information about all cookies under each consent category below.\nThe cookies that are categorised as \"Necessary\" are stored on your browser as they are essential for enabling the basic functionalities of the site. ... Show more\nNecessaryAlways Active\nNecessary cookies are required to enable the basic features of this site, such as providing secure log-in or adjusting your consent preferences. These cookies do not store any personally identifiable data.\n  * Cookie\nBCTempID\n  * Duration\n10 minutes\n  * Description\nNo description available.\n\n\n  * Cookie\n__cf_bm\n  * Duration\n1 hour\n  * Description\nThis cookie, set by Cloudflare, is used to support Cloudflare Bot Management. \n\n\n  * Cookie\nAWSALBCORS\n  * Duration\n7 days\n  * Description\nAmazon Web Services set this cookie for load balancing.\n\n\n  * Cookie\n_cfuvid\n  * Duration\nsession\n  * Description\nCloudflare sets this cookie to track users across sessions to optimize user experience by maintaining session consistency and providing personalized services\n\n\n  * Cookie\nli_gc\n  * Duration\n6 months\n  * Description\nLinkedin set this cookie for storing visitor's consent regarding using cookies for non-essential purposes.\n\n\n  * Cookie\n__hssrc\n  * Duration\nsession\n  * Description\nThis cookie is set by Hubspot whenever it changes the session cookie. The __hssrc cookie set to 1 indicates that the user has restarted the browser, and if the cookie does not exist, it is assumed to be a new session.\n\n\n  * Cookie\n__hssc\n  * Duration\n1 hour\n  * Description\nHubSpot sets this cookie to keep track of sessions and to determine if HubSpot should increment the session number and timestamps in the __hstc cookie.\n\n\n  * Cookie\nwpEmojiSettingsSupports\n  * Duration\nsession\n  * Description\nWordPress sets this cookie when a user interacts with emojis on a WordPress site. It helps determine if the user's browser can display emojis properly.\n\n\n  * Cookie\nBCSessionID\n  * Duration\n1 year 1 month 4 days\n  * Description\nBlueconic sets this cookie as a unique identifier for the BlueConic profile.\n\n\n  * Cookie\n_octo\n  * Duration\n1 year\n  * Description\nNo description available.\n\n\n  * Cookie\nlogged_in\n  * Duration\n1 year\n  * Description\nNo description available.\n\n\n  * Cookie\n__Secure-YEC\n  * Duration\npast\n  * Description\nYouTube sets this cookie to stores the user's video player preferences using embedded YouTube video\n\n\n  * Cookie\n__eoi\n  * Duration\n6 months\n  * Description\nDescription is currently not available.\n\n\n  * Cookie\nAWSALBTGCORS\n  * Duration\n7 days\n  * Description\nNo description available.\n\n\n  * Cookie\nlogin-status-p\n  * Duration\npast\n  * Description\nDescription is currently not available.\n\n\n  * Cookie\nAWSALBTG\n  * Duration\n7 days\n  * Description\nNo description available.\n\n\n  * Cookie\ncsrf_token\n  * Duration\nsession\n  * Description\nNo description available.\n\n\n  * Cookie\ntoken_v2\n  * Duration\n1 day\n  * Description\nDescription is currently not available.\n\n\n  * Cookie\nD\n  * Duration\n1 year\n  * Description\nDescription is currently not available.\n\n\n  * Cookie\nPHPSESSID\n  * Duration\nsession\n  * Description\nThis cookie is native to PHP applications. The cookie stores and identifies a user's unique session ID to manage user sessions on the website. The cookie is a session cookie and will be deleted when all the browser windows are closed.\n\n\n  * Cookie\nVISITOR_PRIVACY_METADATA\n  * Duration\n6 months\n  * Description\nYouTube sets this cookie to store the user's cookie consent state for the current domain. \n\n\n  * Cookie\ncookietest\n  * Duration\nsession\n  * Description\nThe cookietest cookie is typically used to determine whether the user's browser accepts cookies, essential for website functionality and user experience.\n\n\n  * Cookie\n__Host-airtable-session\n  * Duration\n1 year\n  * Description\nThis cookie is used to enable us to integrate the services of Airtable.\n\n\n  * Cookie\n__Host-airtable-session.sig\n  * Duration\n1 year\n  * Description\nThis cookie is used to enable us to integrate the services of Airtable.\n\n\n  * Cookie\nm\n  * Duration\n1 year 1 month 4 days\n  * Description\nStripe sets this cookie for fraud prevention purposes. It identifies the device used to access the website, allowing the website to be formatted accordingly.\n\n\n  * Cookie\nBIGipServer*\n  * Duration\nsession\n  * Description\nMarketo sets this cookie to collect information about the user's online activity and build a profile about their interests to provide advertisements relevant to the user. \n\n\n  * Cookie\n__cfruid\n  * Duration\nsession\n  * Description\nCloudflare sets this cookie to identify trusted web traffic.\n\n\n  * Cookie\n_GRECAPTCHA\n  * Duration\n6 months\n  * Description\nGoogle Recaptcha service sets this cookie to identify bots to protect the website against malicious spam attacks.\n\n\n  * Cookie\n__Secure-YNID\n  * Duration\n6 months\n  * Description\nGoogle cookie used to protect user security and prevent fraud, especially during the login process.\n\n\n  * Cookie\ncookieyes-consent\n  * Duration\n1 year\n  * Description\nCookieYes sets this cookie to remember users' consent preferences so that their preferences are respected on subsequent visits to this site. It does not collect or store any personal information about the site visitors.\n\n\nFunctional\nFunctional cookies help perform certain functionalities like sharing the content of the website on social media platforms, collecting feedback, and other third-party features.\n  * Cookie\nlidc\n  * Duration\n1 day\n  * Description\nLinkedIn sets the lidc cookie to facilitate data center selection.\n\n\n  * Cookie\nbrw\n  * Duration\n1 year\n  * Description\nNo description available.\n\n\n  * Cookie\nbrwConsent\n  * Duration\n5 minutes\n  * Description\nDescription is currently not available.\n\n\n  * Cookie\nWMF-Uniq\n  * Duration\n1 year\n  * Description\nDescription is currently not available.\n\n\n  * Cookie\nloom_anon_comment\n  * Duration\n1 year\n  * Description\nNo description available.\n\n\n  * Cookie\nloom_referral_video\n  * Duration\nsession\n  * Description\nDescription is currently not available.\n\n\n  * Cookie\nVISITOR_INFO1_LIVE\n  * Duration\n6 months\n  * Description\nA cookie set by YouTube to measure bandwidth that determines whether the user gets the new or old player interface.\n\n\n  * Cookie\nyt-remote-connected-devices\n  * Duration\nNever Expires\n  * Description\nYouTube sets this cookie to store the user's video preferences using embedded YouTube videos.\n\n\n  * Cookie\nytidb::LAST_RESULT_ENTRY_KEY\n  * Duration\nNever Expires\n  * Description\nThe cookie ytidb::LAST_RESULT_ENTRY_KEY is used by YouTube to store the last search result entry that was clicked by the user. This information is used to improve the user experience by providing more relevant search results in the future.\n\n\n  * Cookie\nyt-remote-device-id\n  * Duration\nNever Expires\n  * Description\nYouTube sets this cookie to store the user's video preferences using embedded YouTube videos.\n\n\n  * Cookie\nyt-remote-session-name\n  * Duration\nsession\n  * Description\nThe yt-remote-session-name cookie is used by YouTube to store the user's video player preferences using embedded YouTube video.\n\n\n  * Cookie\nyt-remote-fast-check-period\n  * Duration\nsession\n  * Description\nThe yt-remote-fast-check-period cookie is used by YouTube to store the user's video player preferences for embedded YouTube videos.\n\n\n  * Cookie\nyt-remote-session-app\n  * Duration\nsession\n  * Description\nThe yt-remote-session-app cookie is used by YouTube to store user preferences and information about the interface of the embedded YouTube video player.\n\n\n  * Cookie\nyt-remote-cast-available\n  * Duration\nsession\n  * Description\nThe yt-remote-cast-available cookie is used to store the user's preferences regarding whether casting is available on their YouTube video player.\n\n\n  * Cookie\nyt-remote-cast-installed\n  * Duration\nsession\n  * Description\nThe yt-remote-cast-installed cookie is used to store the user's video player preferences using embedded YouTube video.\n\n\n  * Cookie\ncp_session\n  * Duration\n3 months\n  * Description\nCodepen sets this cookie for Help systems found in the website.\n\n\n  * Cookie\nloid\n  * Duration\n1 year 1 month 4 days\n  * Description\nThis cookie is set by the Reddit. The cookie enables the sharing of content from the website onto the social media platform.\n\n\nAnalytics\nAnalytical cookies are used to understand how visitors interact with the website. These cookies help provide information on metrics such as the number of visitors, bounce rate, traffic source, etc.\n  * Cookie\n__hstc\n  * Duration\n6 months\n  * Description\nHubspot set this main cookie for tracking visitors. It contains the domain, initial timestamp (first visit), last timestamp (last visit), current timestamp (this visit), and session number (increments for each subsequent session).\n\n\n  * Cookie\nhubspotutk\n  * Duration\n6 months\n  * Description\nHubSpot sets this cookie to keep track of the visitors to the website. This cookie is passed to HubSpot on form submission and used when deduplicating contacts.\n\n\n  * Cookie\n_ga\n  * Duration\n1 year 1 month 4 days\n  * Description\nGoogle Analytics sets this cookie to calculate visitor, session and campaign data and track site usage for the site's analytics report. The cookie stores information anonymously and assigns a randomly generated number to recognise unique visitors.\n\n\n  * Cookie\n_ga_*\n  * Duration\n1 year 1 month 4 days\n  * Description\nGoogle Analytics sets this cookie to store and count page views.\n\n\n  * Cookie\n__Host-psifi.analyticsTrace\n  * Duration\n6 hours\n  * Description\nDescription is currently not available.\n\n\n  * Cookie\n__Host-psifi.analyticsTraceV2\n  * Duration\n6 hours\n  * Description\nDescription is currently not available.\n\n\n  * Cookie\n_gh_sess\n  * Duration\nsession\n  * Description\nGitHub sets this cookie for temporary application and framework state between pages like what step the user is on in a multiple step form.\n\n\n  * Cookie\nYSC\n  * Duration\nsession\n  * Description\nYSC cookie is set by Youtube and is used to track the views of embedded videos on Youtube pages.\n\n\n  * Cookie\najs_anonymous_id\n  * Duration\n1 year\n  * Description\nThis cookie is set by Segment to count the number of people who visit a certain site by tracking if they have visited before.\n\n\n  * Cookie\nvuid\n  * Duration\n1 year 1 month 4 days\n  * Description\nVimeo installs this cookie to collect tracking information by setting a unique ID to embed videos on the website. \n\n\nPerformance\nPerformance cookies are used to understand and analyse the key performance indexes of the website which helps in delivering a better user experience for the visitors.\n  * Cookie\nAWSALB\n  * Duration\n7 days\n  * Description\nAWSALB is an application load balancer cookie set by Amazon Web Services to map the session to the target.\n\n\n  * Cookie\nacq\n  * Duration\npast\n  * Description\nDescription is currently not available.\n\n\n  * Cookie\nacq.sig\n  * Duration\npast\n  * Description\nDescription is currently not available.\n\n\n  * Cookie\nptc\n  * Duration\n2 years\n  * Description\nNo description available.\n\n\nAdvertisement\nAdvertisement cookies are used to provide visitors with customised advertisements based on the pages you visited previously and to analyse the effectiveness of the ad campaigns.\n  * Cookie\nmuc_ads\n  * Duration\n1 year 1 month 4 days\n  * Description\nTwitter sets this cookie to collect user behaviour and interaction data to optimize the website.\n\n\n  * Cookie\nguest_id_marketing\n  * Duration\n1 year 1 month 4 days\n  * Description\nTwitter sets this cookie to identify and track the website visitor.\n\n\n  * Cookie\nguest_id_ads\n  * Duration\n1 year 1 month 4 days\n  * Description\nTwitter sets this cookie to identify and track the website visitor.\n\n\n  * Cookie\npersonalization_id\n  * Duration\n1 year 1 month 4 days\n  * Description\nTwitter sets this cookie to integrate and share features for social media and also store information about how the user uses the website, for tracking and targeting.\n\n\n  * Cookie\nguest_id\n  * Duration\n1 year 1 month 4 days\n  * Description\nTwitter sets this cookie to identify and track the website visitor. It registers if a user is signed in to the Twitter platform and collects information about ad preferences.\n\n\n  * Cookie\nbcookie\n  * Duration\n1 year\n  * Description\nLinkedIn sets this cookie from LinkedIn share buttons and ad tags to recognize browser IDs.\n\n\n  * Cookie\n__Secure-ROLLOUT_TOKEN\n  * Duration\n6 months\n  * Description\nYouTube sets this cookie to manage feature rollout and experimentation. It helps Google control which new features or interface changes are shown to users as part of testing and staged rollouts, ensuring consistent experience for a given user during an experiment.\n\n\n  * Cookie\nyt.innertube::nextId\n  * Duration\nNever Expires\n  * Description\nYouTube sets this cookie to register a unique ID to store data on what videos from YouTube the user has seen.\n\n\n  * Cookie\nyt.innertube::requests\n  * Duration\nNever Expires\n  * Description\nYouTube sets this cookie to register a unique ID to store data on what videos from YouTube the user has seen.\n\n\n  * Cookie\nsession_tracker\n  * Duration\nsession\n  * Description\nThis cookie is set by the Reddit. This cookie is used to identify trusted web traffic. It also helps in adverstising on the website.\n\n\n  * Cookie\nedgebucket\n  * Duration\nsession\n  * Description\nReddit sets this cookie to save the information about a log-on Reddit user, for the purpose of advertisement recommendations and updating the content.\n\n\n  * Cookie\ndid\n  * Duration\n1 year\n  * Description\nArbor sets this cookie to show targeted ads to site visitors.This cookie expires after 2 months or 1 year.\n\n\nUncategorised\nOther uncategorised cookies are those that are being analysed and have not been classified into a category as yet.\nNo cookies to display.\nReject All Save My Preferences Accept All\nToggle Search[](https://towardsdatascience.com/)Toggle Mobile Navigation\n[](https://towardsdatascience.com/)\nPublish AI, ML & data-science insights to a global community of data professionals.\nSign in[Submit an Article](https://write.insightmediagroup.io)\n[Latest](https://towardsdatascience.com/latest/)[Editor's Picks](https://towardsdatascience.com/tag/editors-pick/)[Newsletter](https://towardsdatascience.com/tag/the-variable/)[ShipAI](https://towardsdatascience.com/shipai/)\n* * *\n[Write For TDS](https://towardsdatascience.com/submissions/)\n[LinkedIn](https://www.linkedin.com/company/towards-data-science/)[X](https://x.com/TDataScience)Toggle Search\n[Data Science](https://towardsdatascience.com/category/data-science/)\n# Collaboration-Friendly SQL Queries\nA few tips to improve the quality of your SQL queries and collaborate better\n[Naser Tamimi](https://towardsdatascience.com/author/tamimi-naser/)\nNovember 8, 20218 min read\n### DATA ENGINEERING AND DATA SCIENCES\n![Photo by the author.](../images/000.png)\nPhoto by the author.\nA data pipeline is stuck and needs someone's attention. Or a query needs to be refactored using a new table because one of the used tables is getting deprecated or unavailable. Or we need to add more to our SQL logic of a very old data pipeline.\nIn all those situations, we have a feeling after a few minutes. We either appreciate the previous code authors, or we get stuck in hundreds of lines of SQL queries. I bet most people (if not all) would like to get appreciated for their work. However, many data engineers and data scientists don't know how to craft SQL queries in collaboration-friendly ways.\nThis article will give you some of the essential tips that help you develop professional and collaboration-friendly SQL queries and data pipelines.\nLearn this step by step with the interactive [AI and Data Scientist](https://roadmap.sh/ai-data-scientist), [Computer Science](https://roadmap.sh/computer-science) and [SQL](https://roadmap.sh/sql) roadmaps.\n## Avoid SELECT *\nDon't get me wrong, I use SELECT _often, but only in my temporary ad-hoc queries to investigate tables or to do quick data check. Rarely (there are a few exceptions that I explain later) use SELECT_ in your pipelines or queries that are non-temporary.\nThe reason that it is important not to use SELECT * is when you want to update or refactor your pipeline or query later. The first thing to update a query (for example, to replace a table with another table) is to understand what columns are used in the query/pipeline. Let's consider an example.\nSuppose we are maintaining a table for recognizing our senior employees based on some metrics. For some reason, we cannot use the `performance_review` table anymore (for example, because of some privacy concerns). Our task is to replace the `performance_review` table with other accessible tables.\ntext\n\n```\nWITH current_senior_employees AS (\n    SELECT *\n    FROM employee\n    WHERE age>=45\n        AND is_current = true\n        AND years_in_company >= 6\n),\nperformance_last_5years AS (\n    SELECT *\n    FROM performance_review\n    WHERE year BETWEEN 2016 AND 2020\n)\nSELECT\n    ARBITRARY(a.first_name), \n    ARBITRARY(a.last_name), \n    ARBITRARY(a.email),    \n    SUM(b.num_of_managed_employees) AS total_num_managed_employees,\n    SUM(b.num_of_managed_projects) AS total_num_of_managed_projects,\n    SUM(b.revenue_generated_by_managed_projects) AS total_revenue\nFROM current_senior_employees AS a\nLEFT JOIN avg_performance_last_5years AS b\nON a.id = b.employee_id\nGROUP BY b.employee_id\n```\n\nAs you can see, due to misuse of SELECT _, we cannot easily recognize what columns from which tables are required to maintain this table. We need to go deeper into the code to find out that_` _num_of_managed_employees_`_,_`_num_of_managed_projects_`_,_`_revenue_generated_by_managed_projects_`_, and_` _employee_id_`_are the columns that we should find in other tables. Of course, my example is super small compared to regular queries in real jobs, and it is not hard to find out which columns are used. But a single query could be hundreds of lines and tens of joined tables in real-life projects. In those situations, it is super hard to go deep into the code to find out which columns are coming from which tables if the programmer uses SELECT_ to read everything first and then select the columns from a bunch of loaded columns.\nIn my example, a better way to write this query is:\ntext\n\n```\nWITH current_senior_employees AS (\n    SELECT \n        id, \n        first_name, \n        last_name, \n        email\n    FROM employee\n    WHERE age>=45\n        AND is_current = true\n        AND years_in_company >= 6\n),\nperformance_last_5years AS (\n    SELECT \n        employee_id, \n        num_of_managed_employees, \n        num_of_managed_projects,\n        revenue_generated_by_managed_projects\n    FROM performance_review\n    WHERE year BETWEEN 2016 AND 2020\n)\nSELECT\n    ARBITRARY(a.first_name), \n    ARBITRARY(a.last_name), \n    ARBITRARY(a.email),    \n    SUM(b.num_of_managed_employees) AS total_num_managed_employees,\n    SUM(b.num_of_managed_projects) AS total_num_of_managed_projects,\n    SUM(b.revenue_generated_by_managed_projects) AS total_revenue\nFROM current_senior_employees AS a\nLEFT JOIN avg_performance_last_5years AS b\nON a.id = b.employee_id\nGROUP BY b.employee_id\n```\n\n## Use aliases\nOne of the bad practices is to avoid using aliases when you join multiple tables. Look a the following example.\ntext\n\n```\nWITH current_senior_employees AS (\n    ...\n),\nperformance_last_5years AS (\n    ...\n)\nSELECT\n    ARBITRARY(first_name), \n    ARBITRARY(last_name), \n    ARBITRARY(email),    \n    SUM(num_of_managed_employees) AS total_num_managed_employees,\n    SUM(num_of_managed_projects) AS total_num_of_managed_projects,\n    SUM(revenue_generated_by_managed_projects) AS total_revenue\nFROM current_senior_employees\nLEFT JOIN avg_performance_last_5years\nON id = employee_id\nGROUP BY employee_id\n```\n\nIt is the same example as the previous section. The only difference is that I did not use aliases (e.g., `a` and `b`) here. In this example, it is difficult to figure out the `email` column is coming from which table. Just because the column name is unique, you should not stop using aliases (especially when you join multiple tables).\nNow imagine if I used SELECT * in addition to not using aliases.\ntext\n\n```\nWITH current_senior_employees AS (\n    SELECT *\n    FROM employee\n    WHERE age>=45\n        AND is_current = true\n        AND years_in_company >= 6\n),\nperformance_last_5years AS (\n    SELECT *\n    FROM performance_review\n    WHERE year BETWEEN 2016 AND 2020\n)\nSELECT\n    ARBITRARY(first_name), \n    ARBITRARY(last_name), \n    ARBITRARY(email),    \n    SUM(num_of_managed_employees) AS total_num_managed_employees,\n    SUM(num_of_managed_projects) AS total_num_of_managed_projects,\n    SUM(revenue_generated_by_managed_projects) AS total_revenue\nFROM current_senior_employees\nLEFT JOIN avg_performance_last_5years\nON id = employee_id\nGROUP BY employee_id\n```\n\nUsing SELECT * and avoiding aliases even for a simple query can lead to big confusion.\nRemember, use aliases to make your query more readable and easier to understand.\n## No meaningless aliases\nStop using meaningless aliases like a, b, c, and so on. The next bad thing after not using aliases is to use meaningless aliases. It is very common among data engineers and scientists to use simple aliases like a and b when they join tables. I am not against using a and b for temporary ad-hoc queries, but I do not use them for long-term queries or pipelines. When you share a query with someone else or go back to your query after a long time, it is not easy to understand it with meaningless aliases. Again for super short queries like the previous example, it is not hard to find out what a and b refer to, but when the query becomes long, it takes too much of our short-term memory to understand the query and fix it when necessary. For example, in my query, I could use:\ntext\n\n```\nWITH current_senior_employees AS (\n    SELECT \n        id, \n        first_name, \n        last_name, \n        email\n    FROM employee\n    WHERE age>=45\n        AND is_current = true\n        AND years_in_company >= 6\n),\nperformance_last_5years AS (\n    SELECT \n        employee_id, \n        num_of_managed_employees, \n        num_of_managed_projects,\n        revenue_generated_by_managed_projects\n    FROM performance_review\n    WHERE year BETWEEN 2016 AND 2020\n)\nSELECT\n    ARBITRARY(employee.first_name), \n    ARBITRARY(employee.last_name), \n    ARBITRARY(employee.email),    \n    SUM(perform.num_of_managed_employees) \n        AS total_num_managed_employees,\n    SUM(perform.num_of_managed_projects) \n        AS total_num_of_managed_projects,\n    SUM(perform.revenue_generated_by_managed_projects) \n        AS total_revenue\nFROM current_senior_employees AS employee\nLEFT JOIN avg_performance_last_5years AS perform\nON employee.id = perform.employee_id\nGROUP BY perform.employee_id\n```\n\n## CTEs are friendly\nDon't be afraid to use CTEs. I have seen Data Engineers and Scientists who use complex nested subqueries to avoid using CTEs (for no obvious reason!). Let me show you how my example query becomes complex if I use subqueries instead of CTEs.\ntext\n\n```\nSELECT\n    ARBITRARY(employee.first_name), \n    ARBITRARY(employee.last_name), \n    ARBITRARY(employee.email),    \n    SUM(perform.num_of_managed_employees) \n        AS total_num_managed_employees,\n    SUM(perform.num_of_managed_projects) \n        AS total_num_of_managed_projects,\n    SUM(perform.revenue_generated_by_managed_projects) \n        AS total_revenue\nFROM (\n    SELECT \n        id, \n        first_name, \n        last_name, \n        email\n    FROM employee\n    WHERE age>=45\n        AND is_current = true\n        AND years_in_company >= 6\n) AS employee\nLEFT JOIN(\n    SELECT \n        employee_id, \n        num_of_managed_employees, \n        num_of_managed_projects,\n        revenue_generated_by_managed_projects\n    FROM performance_review\n    WHERE year BETWEEN 2016 AND 2020\n) AS perform\nON employee.id = perform.employee_id\nGROUP BY perform.employee_id\n```\n\nImagine how complex this could be if we have tens of joined tables (sometimes nested). Remember, there are multiple benefits of using CTEs:\n  1. CTEs are friendly to human short memory (more organized).\n  2. You can use a CTE multiple times in a query and make your query more organized (opposed to subqueries).\n\n\n## Base query using JINJA2\nJinja2 is very popular among data engineers and scientists to develop data pipelines. It enables them to make dynamic queries and compact large ETL queries via `Template()` function. Here I only focus on one of the hundreds of Jinja2 Template applications. My focus is to show you how Jinja2 Template can help you to write more clear SQL queries.\nIf you have multiple queries in your pipeline that use the same CTE or subquery, consider using defining a base query and replacing it in your queries via Jinja2. Here is an example of a pseudo query.\ntext\n\n```\nWITH cte1 AS (\n        SELECT ... \n        FROM table3\n        JOIN (    \n            SELECT \n                ...\n            FROM table1\n            JOIN table2\n            ON table1.col1 = table2.col2\n            WHERE ... \n            AND ... \n        ) AS table_x\n        ON ...\n        WHERE ...),\n    cte2 AS (\n        SELECT ... \n        FROM table4\n        JOIN (\n            SELECT \n                ...\n            FROM table1\n            JOIN table2\n            ON table1.col1 = table2.col2\n            WHERE ... \n            AND ...\n        ) AS table_x\n        ON ...\n        WHERE ...),\n    ) \n    SELECT \n        ... \n    FROM cte1 \n    JOIN cte2 \n    ON ... \n    WHERE ...\n```\n\nIf you look closely, you notice that the bolded subquery is repeated in both `cte1` and `cte2`. Using Jinja2 Template (for example, in Python), you can define a base query for the repeated query and replace it within the main query. You might argue that we can define a CTE instead of using the Jinja2 Template in this example. You are absolutely right! If there is only one query in your pipeline with such a subquery, using a CTE is a much better solution. Still, if you have multiple individual queries in your pipeline (for example, for different tasks) that use the same subquery, then you can use Jinja2 Template to share the same query between them.\nIf you don't know how to use Jinja2 Template, here is an example in Python.\ntext\n\n```\nfrom jinja2 import Template\n```\n\ntext\n\n```\nbase_query = \"\"\" \n    SELECT \n        ... \n    FROM table1\n    JOIN table2\n    ON table1.col1 = table2.col2\n    WHERE ... \n        AND ... \n\"\"\"\n```\n\ntext\n\n```\nmain_query = Template(\"\"\"\n    WITH cte1 AS (\n        SELECT ... \n        FROM table3\n        JOIN ({{subquery}}) AS table_x\n        ON ...\n        WHERE ...),\n    cte2 AS (\n        SELECT ... \n        FROM table4\n        JOIN ({{subquery}}) AS table_x\n        ON ...\n        WHERE ...),\n    ) \n    SELECT \n        ... \n    FROM cte1 \n    JOIN cte2 \n    ON ... \n    WHERE ...\n\"\"\").render(subquery=base_query)\n```\n\n## Some final (but important!!!) tips\nIn the end, I would like to have some crucial general advice for you on how to craft your queries or pipeline for better collaboration.\nThanks to the query optimization feature of most relational database systems, the query you write get optimized before it gets executed. Therefore, in many cases, you may write an inefficient query (for example, loading all columns in a CTE and then selecting columns). However, the optimizer finds an optimum query plan for execution, and the machine performance is still good. However, always remember, just because the optimizer is helping you to have a better performance, it does not mean that you can write queries any way you like. We must be considerate of people who collaborate with us now and in the future to maintain the code.\nFinally, if you think something might take your time at the query development stage, but it will save time later for those who read it, you must do it. For example, it might take you a little bit of time to find and use a proper alias name instead of random \"a\" or \"b,\" but it will save much time later for those who read it later (even yourself).\n* * *\nFollow me on [Medium](https://tamimi-naser.medium.com/) and [Twitter](https://twitter.com/TamimiNas) for the latest stories.\n## Register Now to Continue Reading\n### Unlock Towards Data Science with a Free Account\nAll articles on Towards Data Science are available to registered users. Create a free account today to access this article and thousands more.\nRegister for freeSign in to your account\n* * *\n![](../images/body-909ce5c2500185af5a85.jpeg)\nWritten By\n## [Naser Tamimi](https://towardsdatascience.com/author/tamimi-naser/)\n[See all from Naser Tamimi](https://towardsdatascience.com/author/tamimi-naser/)\n[Data Science](https://towardsdatascience.com/tag/data-science/)[Programming](https://towardsdatascience.com/tag/programming/)[Software Development](https://towardsdatascience.com/tag/software-development/)[Sql](https://towardsdatascience.com/tag/sql/)[Technology](https://towardsdatascience.com/tag/technology/)\nShare This Article\n  * [](https://www.facebook.com/sharer/sharer.php?u=https%3A%2F%2Ftowardsdatascience.com%2Fcollaboration-friendly-sql-queries-ee7e14547a61%2F&title=Collaboration-Friendly%20SQL%20Queries)\n  * [](https://www.linkedin.com/shareArticle?mini=true&url=https%3A%2F%2Ftowardsdatascience.com%2Fcollaboration-friendly-sql-queries-ee7e14547a61%2F&title=Collaboration-Friendly%20SQL%20Queries)\n  * [](https://x.com/share?url=https%3A%2F%2Ftowardsdatascience.com%2Fcollaboration-friendly-sql-queries-ee7e14547a61%2F&text=Collaboration-Friendly%20SQL%20Queries)\n\n\nTowards Data Science is a community publication. Submit your insights to reach our global audience and earn through the TDS Author Payment Program.\n[Write for TDS](https://towardsdatascience.com/submissions/)\n## Related Articles\n  * [![](../images/001.png)](https://towardsdatascience.com/field-boundary-detection-in-satellite-imagery-using-the-sam2-model-b556aa97bf7a/)\n## [Field Boundary Detection in Satellite Imagery Using the SAM2 Model](https://towardsdatascience.com/field-boundary-detection-in-satellite-imagery-using-the-sam2-model-b556aa97bf7a/)\n[Data Science](https://towardsdatascience.com/category/data-science/)\nStep-by-Step Tutorial on Applying Segment Anything Model Version 2 to Satellite Imagery for Detecting and Exporting Field Boundaries in...\n[Mahyar Aboutalebi](https://towardsdatascience.com/author/mahyar.aboutalebi/)\nNovember 15, 202413 min read\n  * [![](../images/002.jpg)](https://towardsdatascience.com/heres-how-openai-codex-will-revolutionize-programming-and-the-world-e8432aafc5f7/)\n## [Here's How OpenAI Codex Will Revolutionize Programming (and the World)](https://towardsdatascience.com/heres-how-openai-codex-will-revolutionize-programming-and-the-world-e8432aafc5f7/)\n[Artificial Intelligence](https://towardsdatascience.com/category/artificial-intelligence/)\n\"Codex gets close to what most of us really want from computers - we say what we want, and they do it.\" - Sam Altman\n[Alberto Romero](https://towardsdatascience.com/author/albertoromgar/)\nAugust 11, 202112 min read\n  * [![](../images/003.png)](https://towardsdatascience.com/python-list-comprehension-is-not-just-syntactic-sugar-346463b4853d/)\n## [Python List Comprehension Is Not Just Syntactic Sugar](https://towardsdatascience.com/python-list-comprehension-is-not-just-syntactic-sugar-346463b4853d/)\n[Machine Learning](https://towardsdatascience.com/category/artificial-intelligence/machine-learning/)\n\"Pythonic\" is not a good reason. Why is the performance better? When not to use it?\n[Christopher Tao](https://towardsdatascience.com/author/christophertao/)\nApril 8, 20248 min read\n  * [![](../images/004.jpg)](https://towardsdatascience.com/automatically-detecting-label-errors-in-datasets-with-cleanlab-e0a3ea5fb345/)\n## [Automatically Detecting Label Errors in Datasets with CleanLab](https://towardsdatascience.com/automatically-detecting-label-errors-in-datasets-with-cleanlab-e0a3ea5fb345/)\n[Artificial Intelligence](https://towardsdatascience.com/category/artificial-intelligence/)\nA Tale of AI and wrongly-classified Brazilian Federal Laws\n[João Pedro](https://towardsdatascience.com/author/joaopedro214/)\nJuly 22, 202310 min read\n  * [![](../images/005.jpg)](https://towardsdatascience.com/train-your-mind-to-think-recursively-in-5-steps-8f85c0e0eb81/)\n## [Train Your Mind to Think Recursively in 5 Steps](https://towardsdatascience.com/train-your-mind-to-think-recursively-in-5-steps-8f85c0e0eb81/)\n[Programming](https://towardsdatascience.com/category/programming/)\nHow to solve recursive problems easily?\n[Sara A. Metwalli](https://towardsdatascience.com/author/saraametwalli/)\nOctober 31, 20207 min read\n  * [![](../images/006.png)](https://towardsdatascience.com/find-the-best-matching-distribution-for-your-data-effortlessly-bcc091aa08ab/)\n## [Find the Best-matching Distribution for Your Data Effortlessly](https://towardsdatascience.com/find-the-best-matching-distribution-for-your-data-effortlessly-bcc091aa08ab/)\n[Machine Learning](https://towardsdatascience.com/category/artificial-intelligence/machine-learning/)\nHow to find the best-matching statistical distributions for your data points - in an automated and easy way.\n[Tirthajyoti Sarkar](https://towardsdatascience.com/author/tirthajyoti/)\nAugust 17, 20215 min read\n  * [![](../images/007.jpeg)](https://towardsdatascience.com/3-beginner-mistakes-ive-made-in-my-data-science-career-a177f1cf751b/)\n## [3 Beginner Mistakes I've Made in My Data Science Career](https://towardsdatascience.com/3-beginner-mistakes-ive-made-in-my-data-science-career-a177f1cf751b/)\n[Artificial Intelligence](https://towardsdatascience.com/category/artificial-intelligence/)\nWriting this feels like career suicide\n[Arunn Thevapalan](https://towardsdatascience.com/author/arunnthevapalan/)\nApril 29, 20218 min read\n  * [![](../images/008.jpg)](https://towardsdatascience.com/breaking-down-state-of-the-art-ppo-implementations-in-jax-6f102c06c149/)\n## [A Practical Guide to Proximal Policy Optimization in JAX](https://towardsdatascience.com/breaking-down-state-of-the-art-ppo-implementations-in-jax-6f102c06c149/)\n[Programming](https://towardsdatascience.com/category/programming/)\nAll the tricks and details you wish you knew about PPO\n[Ryan Pégoud](https://towardsdatascience.com/author/ryanpegoud/)\nMay 1, 20248 min read\n  * [![](../images/009.jpeg)](https://towardsdatascience.com/shannon-information-theory-discovering-particles-of-information-ab2c136c6a25/)\n## [Shannon Information: Discovering Atoms of Communication](https://towardsdatascience.com/shannon-information-theory-discovering-particles-of-information-ab2c136c6a25/)\n[Data Science](https://towardsdatascience.com/category/data-science/)\nPhysical objects have atoms, information has bits. Claude Shannon believes that information, although intangible, can be quantified...\n[Casey Cheng](https://towardsdatascience.com/author/casey-cheng/)\nMarch 21, 202214 min read\n\n\n  * [YouTube](https://www.youtube.com/c/TowardsDataScience)\n  * [X](https://x.com/TDataScience)\n  * [LinkedIn](https://www.linkedin.com/company/towards-data-science/)\n  * [Threads](https://www.threads.net/@towardsdatascience)\n  * [Bluesky](https://bsky.app/profile/towardsdatascience.com)\n\n\n[](https://towardsdatascience.com/)\nYour home for data science and AI. The world's leading publication for data science, data analytics, data engineering, machine learning, and artificial intelligence professionals.\nSubscribe to Our Newsletter[Write For TDS](https://towardsdatascience.com/submissions/)•[About](https://towardsdatascience.com/about-towards-data-science-d691af11cc2f/)•[Advertise](https://contact.towardsdatascience.com/advertise-with-towards-data-science)•[Privacy Policy](https://towardsdatascience.com/privacy-policy/)•[Terms of Use](https://towardsdatascience.com/website-terms-of-use/)\n© Insight Media Group, LLC 2026•[The New Stack](https://thenewstack.io)•[roadmap.sh](https://roadmap.sh)•[Creator Network](https://insightmediagroup.io/creator-network)\n####  Recommended Articles \nClose\n  * [ ![](https://h030.towardsdatascience.com/rest/v2/contentStores/d7d3a4ab-7caf-4383-bbd2-fbf7fb4f1787/items/607686/image?etag=1782161464448&width=500&height=500) How Relevance Models Foreshadowed Transformers for NLP ](https://towardsdatascience.com/how-relevance-models-foreshadowed-transformers-for-nlp/ \"How Relevance Models Foreshadowed Transformers for NLP\")\n  * [ ![](https://h030.towardsdatascience.com/rest/v2/contentStores/d7d3a4ab-7caf-4383-bbd2-fbf7fb4f1787/items/607639/image?etag=1781250125848&width=500&height=500) Javascript Fatigue: HTMX Is All You Need to Build ChatGPT — Part 1 ](https://towardsdatascience.com/javascript-fatigue-you-dont-need-js-to-build-chatgpt/ \"Javascript Fatigue: HTMX Is All You Need to Build ChatGPT — Part 1\")\n  * [ ![](https://h030.towardsdatascience.com/rest/v2/contentStores/d7d3a4ab-7caf-4383-bbd2-fbf7fb4f1787/items/607930/image?etag=1782124566054&width=500&height=500) The Subset Sum Problem Solved in Linear Time for Dense Enough Inputs ](https://towardsdatascience.com/subset-sum-problem-solved-in-linear-time-for-dense-enough-inputs/ \"The Subset Sum Problem Solved in Linear Time for Dense Enough Inputs\")\n  * [ ![](https://h030.towardsdatascience.com/rest/v2/contentStores/d7d3a4ab-7caf-4383-bbd2-fbf7fb4f1787/items/3660/image?etag=1780176246070&width=500&height=500) Does Your Company Have a Data Strategy? ](https://towardsdatascience.com/does-your-company-have-a-data-strategy-e8944dbec4ae/ \"Does Your Company Have a Data Strategy?\")\n\n\n",
  "metadata": {
    "title": "Collaboration-Friendly SQL Queries | Towards Data Science",
    "description": "A few tips to improve the quality of your SQL queries and collaborate better",
    "keywords": null,
    "author": "Naser Tamimi",
    "og:locale": "en_US",
    "og:type": "article",
    "og:title": "Collaboration-Friendly SQL Queries",
    "og:description": "A few tips to improve the quality of your SQL queries and collaborate better",
    "og:url": "https://towardsdatascience.com/collaboration-friendly-sql-queries-ee7e14547a61/",
    "og:site_name": "Towards Data Science",
    "og:image": "https://assets.insightmediagroup.io/media/wp-content/uploads/2021/11/1Qp1ADHXEMEK5sATpenc5Ug.png",
    "og:image:width": "1280",
    "og:image:height": "720",
    "og:image:type": "image/png",
    "twitter:card": "summary_large_image",
    "twitter:site": "@TDataScience",
    "twitter:creator": "@TDataScience",
    "twitter:label1": "Written by",
    "twitter:data1": "Naser Tamimi",
    "twitter:label2": "Est. reading time",
    "twitter:data2": "8 min read",
    "article:published_time": "2021-11-08T16:26:47.000Z",
    "article:modified_time": "2021-11-08T16:26:47.000Z",
    "article:author": "https://towardsdatascience.com/author/tamimi-naser/"
  },
  "paywall": {
    "listed_paid": false,
    "detected": false,
    "marker": "",
    "public_only": false,
    "policy": "付费/会员内容只保留页面公开可见部分，不绕过付费墙"
  },
  "crawl": {
    "success": true,
    "status_code": 200,
    "error": ""
  },
  "code_blocks": [
    {
      "language": "txt",
      "file": "attachments/d8ec7b320c8b/code/block_000.txt",
      "chars": 682
    },
    {
      "language": "txt",
      "file": "attachments/d8ec7b320c8b/code/block_001.txt",
      "chars": 884
    },
    {
      "language": "txt",
      "file": "attachments/d8ec7b320c8b/code/block_002.txt",
      "chars": 479
    },
    {
      "language": "txt",
      "file": "attachments/d8ec7b320c8b/code/block_003.txt",
      "chars": 654
    },
    {
      "language": "txt",
      "file": "attachments/d8ec7b320c8b/code/block_004.txt",
      "chars": 982
    },
    {
      "language": "txt",
      "file": "attachments/d8ec7b320c8b/code/block_005.txt",
      "chars": 867
    },
    {
      "language": "txt",
      "file": "attachments/d8ec7b320c8b/code/block_006.txt",
      "chars": 688
    },
    {
      "language": "txt",
      "file": "attachments/d8ec7b320c8b/code/block_007.txt",
      "chars": 28
    },
    {
      "language": "txt",
      "file": "attachments/d8ec7b320c8b/code/block_008.txt",
      "chars": 144
    },
    {
      "language": "txt",
      "file": "attachments/d8ec7b320c8b/code/block_009.txt",
      "chars": 408
    }
  ],
  "images": [
    {
      "status": "http_404",
      "url": "https://h030.towardsdatascience.com/rest/v2/contentStores/d7d3a4ab-7caf-4383-bbd2-fbf7fb4f1787/items/607686/image?etag=1782161464448&width=500&height=500",
      "src": "https://h030.towardsdatascience.com/rest/v2/contentStores/d7d3a4ab-7caf-4383-bbd2-fbf7fb4f1787/items/607686/image?etag=1782161464448&width=500&height=500",
      "alt": "",
      "downloaded": false,
      "discovery": "saved_markdown",
      "retried_at": "2026-10-20T17:42:16Z"
    },
    {
      "status": "http_404",
      "url": "https://h030.towardsdatascience.com/rest/v2/contentStores/d7d3a4ab-7caf-4383-bbd2-fbf7fb4f1787/items/607639/image?etag=1781250125848&width=500&height=500",
      "src": "https://h030.towardsdatascience.com/rest/v2/contentStores/d7d3a4ab-7caf-4383-bbd2-fbf7fb4f1787/items/607639/image?etag=1781250125848&width=500&height=500",
      "alt": "",
      "downloaded": false,
      "discovery": "saved_markdown",
      "retried_at": "2026-10-20T17:42:16Z"
    },
    {
      "status": "http_404",
      "url": "https://h030.towardsdatascience.com/rest/v2/contentStores/d7d3a4ab-7caf-4383-bbd2-fbf7fb4f1787/items/607930/image?etag=1782124566054&width=500&height=500",
      "src": "https://h030.towardsdatascience.com/rest/v2/contentStores/d7d3a4ab-7caf-4383-bbd2-fbf7fb4f1787/items/607930/image?etag=1782124566054&width=500&height=500",
      "alt": "",
      "downloaded": false,
      "discovery": "saved_markdown",
      "retried_at": "2026-10-20T17:42:16Z"
    },
    {
      "status": "http_404",
      "url": "https://h030.towardsdatascience.com/rest/v2/contentStores/d7d3a4ab-7caf-4383-bbd2-fbf7fb4f1787/items/3660/image?etag=1780176246070&width=500&height=500",
      "src": "https://h030.towardsdatascience.com/rest/v2/contentStores/d7d3a4ab-7caf-4383-bbd2-fbf7fb4f1787/items/3660/image?etag=1780176246070&width=500&height=500",
      "alt": "",
      "downloaded": false,
      "discovery": "saved_markdown",
      "retried_at": "2026-10-20T17:42:16Z"
    }
  ],
  "audio": [],
  "videos": [
    {
      "url": "https://www.youtube.com/c/TowardsDataScience",
      "kind": "channel_reference",
      "status": "reference_only"
    }
  ],
  "links": [
    {
      "type": "internal",
      "href": "https://towardsdatascience.com/"
    },
    {
      "type": "internal",
      "href": "https://towardsdatascience.com/latest/"
    },
    {
      "type": "internal",
      "href": "https://towardsdatascience.com/tag/editors-pick/"
    },
    {
      "type": "internal",
      "href": "https://towardsdatascience.com/tag/the-variable/"
    },
    {
      "type": "internal",
      "href": "https://towardsdatascience.com/shipai/"
    },
    {
      "type": "internal",
      "href": "https://towardsdatascience.com/submissions/"
    },
    {
      "type": "internal",
      "href": "https://towardsdatascience.com/category/data-science/"
    },
    {
      "type": "internal",
      "href": "https://towardsdatascience.com/author/tamimi-naser/"
    },
    {
      "type": "internal",
      "href": "https://towardsdatascience.com/tag/data-science/"
    },
    {
      "type": "internal",
      "href": "https://towardsdatascience.com/tag/programming/"
    },
    {
      "type": "internal",
      "href": "https://towardsdatascience.com/tag/software-development/"
    },
    {
      "type": "internal",
      "href": "https://towardsdatascience.com/tag/sql/"
    },
    {
      "type": "internal",
      "href": "https://towardsdatascience.com/tag/technology/"
    },
    {
      "type": "internal",
      "href": "https://towardsdatascience.com/field-boundary-detection-in-satellite-imagery-using-the-sam2-model-b556aa97bf7a/"
    },
    {
      "type": "internal",
      "href": "https://towardsdatascience.com/author/mahyar.aboutalebi/"
    },
    {
      "type": "internal",
      "href": "https://towardsdatascience.com/heres-how-openai-codex-will-revolutionize-programming-and-the-world-e8432aafc5f7/"
    },
    {
      "type": "internal",
      "href": "https://towardsdatascience.com/category/artificial-intelligence/"
    },
    {
      "type": "internal",
      "href": "https://towardsdatascience.com/author/albertoromgar/"
    },
    {
      "type": "internal",
      "href": "https://towardsdatascience.com/python-list-comprehension-is-not-just-syntactic-sugar-346463b4853d/"
    },
    {
      "type": "internal",
      "href": "https://towardsdatascience.com/category/artificial-intelligence/machine-learning/"
    },
    {
      "type": "external",
      "href": "https://write.insightmediagroup.io"
    },
    {
      "type": "external",
      "href": "https://www.linkedin.com/company/towards-data-science/"
    },
    {
      "type": "external",
      "href": "https://x.com/TDataScience"
    },
    {
      "type": "external",
      "href": "https://roadmap.sh/ai-data-scientist"
    },
    {
      "type": "external",
      "href": "https://roadmap.sh/computer-science"
    },
    {
      "type": "external",
      "href": "https://roadmap.sh/sql"
    },
    {
      "type": "external",
      "href": "https://tamimi-naser.medium.com/"
    },
    {
      "type": "external",
      "href": "https://twitter.com/TamimiNas"
    },
    {
      "type": "external",
      "href": "https://www.facebook.com/sharer/sharer.php?title=Collaboration-Friendly+SQL+Queries&u=https%3A%2F%2Ftowardsdatascience.com%2Fcollaboration-friendly-sql-queries-ee7e14547a61%2F"
    },
    {
      "type": "external",
      "href": "https://www.linkedin.com/shareArticle?mini=true&title=Collaboration-Friendly+SQL+Queries&url=https%3A%2F%2Ftowardsdatascience.com%2Fcollaboration-friendly-sql-queries-ee7e14547a61%2F"
    },
    {
      "type": "external",
      "href": "https://x.com/share?text=Collaboration-Friendly+SQL+Queries&url=https%3A%2F%2Ftowardsdatascience.com%2Fcollaboration-friendly-sql-queries-ee7e14547a61%2F"
    },
    {
      "type": "external",
      "href": "https://www.youtube.com/c/TowardsDataScience"
    },
    {
      "type": "external",
      "href": "https://www.threads.net/@towardsdatascience"
    },
    {
      "type": "external",
      "href": "https://bsky.app/profile/towardsdatascience.com"
    },
    {
      "type": "external",
      "href": "https://thenewstack.io"
    },
    {
      "type": "external",
      "href": "https://roadmap.sh"
    },
    {
      "type": "external",
      "href": "https://insightmediagroup.io/creator-network"
    }
  ],
  "repair_version": 2,
  "repaired_at": "2026-10-20T17:25:30Z",
  "source_url": "https://towardsdatascience.com/collaboration-friendly-sql-queries-ee7e14547a61/",
  "delivery_status": "unverified",
  "discovery_status": "http_403",
  "missing_reason": "源页面未重新核验:http_403；已按保留正文补采图片",
  "repair_error": "",
  "actual_video_files": [],
  "expected_saved_body_images": 4,
  "image_discovery": "saved_markdown",
  "source_body_markdown": "![Revisit consent button](https://cdn-cookieyes.com/assets/images/revisit.svg)\nWe value your privacy\nWe use cookies to enhance your browsing experience, serve personalised ads or content, and analyse our traffic. By clicking \"Accept All\", you consent to our use of cookies.\nCustomise Reject All Accept All\nCustomise Consent Preferences ![](https://cdn-cookieyes.com/assets/images/close.svg)\nWe use cookies to help you navigate efficiently and perform certain functions. You will find detailed information about all cookies under each consent category below.\nThe cookies that are categorised as \"Necessary\" are stored on your browser as they are essential for enabling the basic functionalities of the site. ... Show more\nNecessaryAlways Active\nNecessary cookies are required to enable the basic features of this site, such as providing secure log-in or adjusting your consent preferences. These cookies do not store any personally identifiable data.\n  * Cookie\nBCTempID\n  * Duration\n10 minutes\n  * Description\nNo description available.\n\n\n  * Cookie\n__cf_bm\n  * Duration\n1 hour\n  * Description\nThis cookie, set by Cloudflare, is used to support Cloudflare Bot Management. \n\n\n  * Cookie\nAWSALBCORS\n  * Duration\n7 days\n  * Description\nAmazon Web Services set this cookie for load balancing.\n\n\n  * Cookie\n_cfuvid\n  * Duration\nsession\n  * Description\nCloudflare sets this cookie to track users across sessions to optimize user experience by maintaining session consistency and providing personalized services\n\n\n  * Cookie\nli_gc\n  * Duration\n6 months\n  * Description\nLinkedin set this cookie for storing visitor's consent regarding using cookies for non-essential purposes.\n\n\n  * Cookie\n__hssrc\n  * Duration\nsession\n  * Description\nThis cookie is set by Hubspot whenever it changes the session cookie. The __hssrc cookie set to 1 indicates that the user has restarted the browser, and if the cookie does not exist, it is assumed to be a new session.\n\n\n  * Cookie\n__hssc\n  * Duration\n1 hour\n  * Description\nHubSpot sets this cookie to keep track of sessions and to determine if HubSpot should increment the session number and timestamps in the __hstc cookie.\n\n\n  * Cookie\nwpEmojiSettingsSupports\n  * Duration\nsession\n  * Description\nWordPress sets this cookie when a user interacts with emojis on a WordPress site. It helps determine if the user's browser can display emojis properly.\n\n\n  * Cookie\nBCSessionID\n  * Duration\n1 year 1 month 4 days\n  * Description\nBlueconic sets this cookie as a unique identifier for the BlueConic profile.\n\n\n  * Cookie\n_octo\n  * Duration\n1 year\n  * Description\nNo description available.\n\n\n  * Cookie\nlogged_in\n  * Duration\n1 year\n  * Description\nNo description available.\n\n\n  * Cookie\n__Secure-YEC\n  * Duration\npast\n  * Description\nYouTube sets this cookie to stores the user's video player preferences using embedded YouTube video\n\n\n  * Cookie\n__eoi\n  * Duration\n6 months\n  * Description\nDescription is currently not available.\n\n\n  * Cookie\nAWSALBTGCORS\n  * Duration\n7 days\n  * Description\nNo description available.\n\n\n  * Cookie\nlogin-status-p\n  * Duration\npast\n  * Description\nDescription is currently not available.\n\n\n  * Cookie\nAWSALBTG\n  * Duration\n7 days\n  * Description\nNo description available.\n\n\n  * Cookie\ncsrf_token\n  * Duration\nsession\n  * Description\nNo description available.\n\n\n  * Cookie\ntoken_v2\n  * Duration\n1 day\n  * Description\nDescription is currently not available.\n\n\n  * Cookie\nD\n  * Duration\n1 year\n  * Description\nDescription is currently not available.\n\n\n  * Cookie\nPHPSESSID\n  * Duration\nsession\n  * Description\nThis cookie is native to PHP applications. The cookie stores and identifies a user's unique session ID to manage user sessions on the website. The cookie is a session cookie and will be deleted when all the browser windows are closed.\n\n\n  * Cookie\nVISITOR_PRIVACY_METADATA\n  * Duration\n6 months\n  * Description\nYouTube sets this cookie to store the user's cookie consent state for the current domain. \n\n\n  * Cookie\ncookietest\n  * Duration\nsession\n  * Description\nThe cookietest cookie is typically used to determine whether the user's browser accepts cookies, essential for website functionality and user experience.\n\n\n  * Cookie\n__Host-airtable-session\n  * Duration\n1 year\n  * Description\nThis cookie is used to enable us to integrate the services of Airtable.\n\n\n  * Cookie\n__Host-airtable-session.sig\n  * Duration\n1 year\n  * Description\nThis cookie is used to enable us to integrate the services of Airtable.\n\n\n  * Cookie\nm\n  * Duration\n1 year 1 month 4 days\n  * Description\nStripe sets this cookie for fraud prevention purposes. It identifies the device used to access the website, allowing the website to be formatted accordingly.\n\n\n  * Cookie\nBIGipServer*\n  * Duration\nsession\n  * Description\nMarketo sets this cookie to collect information about the user's online activity and build a profile about their interests to provide advertisements relevant to the user. \n\n\n  * Cookie\n__cfruid\n  * Duration\nsession\n  * Description\nCloudflare sets this cookie to identify trusted web traffic.\n\n\n  * Cookie\n_GRECAPTCHA\n  * Duration\n6 months\n  * Description\nGoogle Recaptcha service sets this cookie to identify bots to protect the website against malicious spam attacks.\n\n\n  * Cookie\n__Secure-YNID\n  * Duration\n6 months\n  * Description\nGoogle cookie used to protect user security and prevent fraud, especially during the login process.\n\n\n  * Cookie\ncookieyes-consent\n  * Duration\n1 year\n  * Description\nCookieYes sets this cookie to remember users' consent preferences so that their preferences are respected on subsequent visits to this site. It does not collect or store any personal information about the site visitors.\n\n\nFunctional\nFunctional cookies help perform certain functionalities like sharing the content of the website on social media platforms, collecting feedback, and other third-party features.\n  * Cookie\nlidc\n  * Duration\n1 day\n  * Description\nLinkedIn sets the lidc cookie to facilitate data center selection.\n\n\n  * Cookie\nbrw\n  * Duration\n1 year\n  * Description\nNo description available.\n\n\n  * Cookie\nbrwConsent\n  * Duration\n5 minutes\n  * Description\nDescription is currently not available.\n\n\n  * Cookie\nWMF-Uniq\n  * Duration\n1 year\n  * Description\nDescription is currently not available.\n\n\n  * Cookie\nloom_anon_comment\n  * Duration\n1 year\n  * Description\nNo description available.\n\n\n  * Cookie\nloom_referral_video\n  * Duration\nsession\n  * Description\nDescription is currently not available.\n\n\n  * Cookie\nVISITOR_INFO1_LIVE\n  * Duration\n6 months\n  * Description\nA cookie set by YouTube to measure bandwidth that determines whether the user gets the new or old player interface.\n\n\n  * Cookie\nyt-remote-connected-devices\n  * Duration\nNever Expires\n  * Description\nYouTube sets this cookie to store the user's video preferences using embedded YouTube videos.\n\n\n  * Cookie\nytidb::LAST_RESULT_ENTRY_KEY\n  * Duration\nNever Expires\n  * Description\nThe cookie ytidb::LAST_RESULT_ENTRY_KEY is used by YouTube to store the last search result entry that was clicked by the user. This information is used to improve the user experience by providing more relevant search results in the future.\n\n\n  * Cookie\nyt-remote-device-id\n  * Duration\nNever Expires\n  * Description\nYouTube sets this cookie to store the user's video preferences using embedded YouTube videos.\n\n\n  * Cookie\nyt-remote-session-name\n  * Duration\nsession\n  * Description\nThe yt-remote-session-name cookie is used by YouTube to store the user's video player preferences using embedded YouTube video.\n\n\n  * Cookie\nyt-remote-fast-check-period\n  * Duration\nsession\n  * Description\nThe yt-remote-fast-check-period cookie is used by YouTube to store the user's video player preferences for embedded YouTube videos.\n\n\n  * Cookie\nyt-remote-session-app\n  * Duration\nsession\n  * Description\nThe yt-remote-session-app cookie is used by YouTube to store user preferences and information about the interface of the embedded YouTube video player.\n\n\n  * Cookie\nyt-remote-cast-available\n  * Duration\nsession\n  * Description\nThe yt-remote-cast-available cookie is used to store the user's preferences regarding whether casting is available on their YouTube video player.\n\n\n  * Cookie\nyt-remote-cast-installed\n  * Duration\nsession\n  * Description\nThe yt-remote-cast-installed cookie is used to store the user's video player preferences using embedded YouTube video.\n\n\n  * Cookie\ncp_session\n  * Duration\n3 months\n  * Description\nCodepen sets this cookie for Help systems found in the website.\n\n\n  * Cookie\nloid\n  * Duration\n1 year 1 month 4 days\n  * Description\nThis cookie is set by the Reddit. The cookie enables the sharing of content from the website onto the social media platform.\n\n\nAnalytics\nAnalytical cookies are used to understand how visitors interact with the website. These cookies help provide information on metrics such as the number of visitors, bounce rate, traffic source, etc.\n  * Cookie\n__hstc\n  * Duration\n6 months\n  * Description\nHubspot set this main cookie for tracking visitors. It contains the domain, initial timestamp (first visit), last timestamp (last visit), current timestamp (this visit), and session number (increments for each subsequent session).\n\n\n  * Cookie\nhubspotutk\n  * Duration\n6 months\n  * Description\nHubSpot sets this cookie to keep track of the visitors to the website. This cookie is passed to HubSpot on form submission and used when deduplicating contacts.\n\n\n  * Cookie\n_ga\n  * Duration\n1 year 1 month 4 days\n  * Description\nGoogle Analytics sets this cookie to calculate visitor, session and campaign data and track site usage for the site's analytics report. The cookie stores information anonymously and assigns a randomly generated number to recognise unique visitors.\n\n\n  * Cookie\n_ga_*\n  * Duration\n1 year 1 month 4 days\n  * Description\nGoogle Analytics sets this cookie to store and count page views.\n\n\n  * Cookie\n__Host-psifi.analyticsTrace\n  * Duration\n6 hours\n  * Description\nDescription is currently not available.\n\n\n  * Cookie\n__Host-psifi.analyticsTraceV2\n  * Duration\n6 hours\n  * Description\nDescription is currently not available.\n\n\n  * Cookie\n_gh_sess\n  * Duration\nsession\n  * Description\nGitHub sets this cookie for temporary application and framework state between pages like what step the user is on in a multiple step form.\n\n\n  * Cookie\nYSC\n  * Duration\nsession\n  * Description\nYSC cookie is set by Youtube and is used to track the views of embedded videos on Youtube pages.\n\n\n  * Cookie\najs_anonymous_id\n  * Duration\n1 year\n  * Description\nThis cookie is set by Segment to count the number of people who visit a certain site by tracking if they have visited before.\n\n\n  * Cookie\nvuid\n  * Duration\n1 year 1 month 4 days\n  * Description\nVimeo installs this cookie to collect tracking information by setting a unique ID to embed videos on the website. \n\n\nPerformance\nPerformance cookies are used to understand and analyse the key performance indexes of the website which helps in delivering a better user experience for the visitors.\n  * Cookie\nAWSALB\n  * Duration\n7 days\n  * Description\nAWSALB is an application load balancer cookie set by Amazon Web Services to map the session to the target.\n\n\n  * Cookie\nacq\n  * Duration\npast\n  * Description\nDescription is currently not available.\n\n\n  * Cookie\nacq.sig\n  * Duration\npast\n  * Description\nDescription is currently not available.\n\n\n  * Cookie\nptc\n  * Duration\n2 years\n  * Description\nNo description available.\n\n\nAdvertisement\nAdvertisement cookies are used to provide visitors with customised advertisements based on the pages you visited previously and to analyse the effectiveness of the ad campaigns.\n  * Cookie\nmuc_ads\n  * Duration\n1 year 1 month 4 days\n  * Description\nTwitter sets this cookie to collect user behaviour and interaction data to optimize the website.\n\n\n  * Cookie\nguest_id_marketing\n  * Duration\n1 year 1 month 4 days\n  * Description\nTwitter sets this cookie to identify and track the website visitor.\n\n\n  * Cookie\nguest_id_ads\n  * Duration\n1 year 1 month 4 days\n  * Description\nTwitter sets this cookie to identify and track the website visitor.\n\n\n  * Cookie\npersonalization_id\n  * Duration\n1 year 1 month 4 days\n  * Description\nTwitter sets this cookie to integrate and share features for social media and also store information about how the user uses the website, for tracking and targeting.\n\n\n  * Cookie\nguest_id\n  * Duration\n1 year 1 month 4 days\n  * Description\nTwitter sets this cookie to identify and track the website visitor. It registers if a user is signed in to the Twitter platform and collects information about ad preferences.\n\n\n  * Cookie\nbcookie\n  * Duration\n1 year\n  * Description\nLinkedIn sets this cookie from LinkedIn share buttons and ad tags to recognize browser IDs.\n\n\n  * Cookie\n__Secure-ROLLOUT_TOKEN\n  * Duration\n6 months\n  * Description\nYouTube sets this cookie to manage feature rollout and experimentation. It helps Google control which new features or interface changes are shown to users as part of testing and staged rollouts, ensuring consistent experience for a given user during an experiment.\n\n\n  * Cookie\nyt.innertube::nextId\n  * Duration\nNever Expires\n  * Description\nYouTube sets this cookie to register a unique ID to store data on what videos from YouTube the user has seen.\n\n\n  * Cookie\nyt.innertube::requests\n  * Duration\nNever Expires\n  * Description\nYouTube sets this cookie to register a unique ID to store data on what videos from YouTube the user has seen.\n\n\n  * Cookie\nsession_tracker\n  * Duration\nsession\n  * Description\nThis cookie is set by the Reddit. This cookie is used to identify trusted web traffic. It also helps in adverstising on the website.\n\n\n  * Cookie\nedgebucket\n  * Duration\nsession\n  * Description\nReddit sets this cookie to save the information about a log-on Reddit user, for the purpose of advertisement recommendations and updating the content.\n\n\n  * Cookie\ndid\n  * Duration\n1 year\n  * Description\nArbor sets this cookie to show targeted ads to site visitors.This cookie expires after 2 months or 1 year.\n\n\nUncategorised\nOther uncategorised cookies are those that are being analysed and have not been classified into a category as yet.\nNo cookies to display.\nReject All Save My Preferences Accept All\nToggle Search[](https://towardsdatascience.com/)Toggle Mobile Navigation\n[](https://towardsdatascience.com/)\nPublish AI, ML & data-science insights to a global community of data professionals.\nSign in[Submit an Article](https://write.insightmediagroup.io)\n[Latest](https://towardsdatascience.com/latest/)[Editor's Picks](https://towardsdatascience.com/tag/editors-pick/)[Newsletter](https://towardsdatascience.com/tag/the-variable/)[ShipAI](https://towardsdatascience.com/shipai/)\n* * *\n[Write For TDS](https://towardsdatascience.com/submissions/)\n[LinkedIn](https://www.linkedin.com/company/towards-data-science/)[X](https://x.com/TDataScience)Toggle Search\n[Data Science](https://towardsdatascience.com/category/data-science/)\n# Collaboration-Friendly SQL Queries\nA few tips to improve the quality of your SQL queries and collaborate better\n[Naser Tamimi](https://towardsdatascience.com/author/tamimi-naser/)\nNovember 8, 20218 min read\n### DATA ENGINEERING AND DATA SCIENCES\n![Photo by the author.](https://assets.insightmediagroup.io/media/wp-content/uploads/2021/11/1Qp1ADHXEMEK5sATpenc5Ug.png)\nPhoto by the author.\nA data pipeline is stuck and needs someone's attention. Or a query needs to be refactored using a new table because one of the used tables is getting deprecated or unavailable. Or we need to add more to our SQL logic of a very old data pipeline.\nIn all those situations, we have a feeling after a few minutes. We either appreciate the previous code authors, or we get stuck in hundreds of lines of SQL queries. I bet most people (if not all) would like to get appreciated for their work. However, many data engineers and data scientists don't know how to craft SQL queries in collaboration-friendly ways.\nThis article will give you some of the essential tips that help you develop professional and collaboration-friendly SQL queries and data pipelines.\nLearn this step by step with the interactive [AI and Data Scientist](https://roadmap.sh/ai-data-scientist), [Computer Science](https://roadmap.sh/computer-science) and [SQL](https://roadmap.sh/sql) roadmaps.\n## Avoid SELECT *\nDon't get me wrong, I use SELECT _often, but only in my temporary ad-hoc queries to investigate tables or to do quick data check. Rarely (there are a few exceptions that I explain later) use SELECT_ in your pipelines or queries that are non-temporary.\nThe reason that it is important not to use SELECT * is when you want to update or refactor your pipeline or query later. The first thing to update a query (for example, to replace a table with another table) is to understand what columns are used in the query/pipeline. Let's consider an example.\nSuppose we are maintaining a table for recognizing our senior employees based on some metrics. For some reason, we cannot use the `performance_review` table anymore (for example, because of some privacy concerns). Our task is to replace the `performance_review` table with other accessible tables.\ntext\n\n```\nWITH current_senior_employees AS (\n    SELECT *\n    FROM employee\n    WHERE age>=45\n        AND is_current = true\n        AND years_in_company >= 6\n),\nperformance_last_5years AS (\n    SELECT *\n    FROM performance_review\n    WHERE year BETWEEN 2016 AND 2020\n)\nSELECT\n    ARBITRARY(a.first_name), \n    ARBITRARY(a.last_name), \n    ARBITRARY(a.email),    \n    SUM(b.num_of_managed_employees) AS total_num_managed_employees,\n    SUM(b.num_of_managed_projects) AS total_num_of_managed_projects,\n    SUM(b.revenue_generated_by_managed_projects) AS total_revenue\nFROM current_senior_employees AS a\nLEFT JOIN avg_performance_last_5years AS b\nON a.id = b.employee_id\nGROUP BY b.employee_id\n```\n\nAs you can see, due to misuse of SELECT _, we cannot easily recognize what columns from which tables are required to maintain this table. We need to go deeper into the code to find out that_` _num_of_managed_employees_`_,_`_num_of_managed_projects_`_,_`_revenue_generated_by_managed_projects_`_, and_` _employee_id_`_are the columns that we should find in other tables. Of course, my example is super small compared to regular queries in real jobs, and it is not hard to find out which columns are used. But a single query could be hundreds of lines and tens of joined tables in real-life projects. In those situations, it is super hard to go deep into the code to find out which columns are coming from which tables if the programmer uses SELECT_ to read everything first and then select the columns from a bunch of loaded columns.\nIn my example, a better way to write this query is:\ntext\n\n```\nWITH current_senior_employees AS (\n    SELECT \n        id, \n        first_name, \n        last_name, \n        email\n    FROM employee\n    WHERE age>=45\n        AND is_current = true\n        AND years_in_company >= 6\n),\nperformance_last_5years AS (\n    SELECT \n        employee_id, \n        num_of_managed_employees, \n        num_of_managed_projects,\n        revenue_generated_by_managed_projects\n    FROM performance_review\n    WHERE year BETWEEN 2016 AND 2020\n)\nSELECT\n    ARBITRARY(a.first_name), \n    ARBITRARY(a.last_name), \n    ARBITRARY(a.email),    \n    SUM(b.num_of_managed_employees) AS total_num_managed_employees,\n    SUM(b.num_of_managed_projects) AS total_num_of_managed_projects,\n    SUM(b.revenue_generated_by_managed_projects) AS total_revenue\nFROM current_senior_employees AS a\nLEFT JOIN avg_performance_last_5years AS b\nON a.id = b.employee_id\nGROUP BY b.employee_id\n```\n\n## Use aliases\nOne of the bad practices is to avoid using aliases when you join multiple tables. Look a the following example.\ntext\n\n```\nWITH current_senior_employees AS (\n    ...\n),\nperformance_last_5years AS (\n    ...\n)\nSELECT\n    ARBITRARY(first_name), \n    ARBITRARY(last_name), \n    ARBITRARY(email),    \n    SUM(num_of_managed_employees) AS total_num_managed_employees,\n    SUM(num_of_managed_projects) AS total_num_of_managed_projects,\n    SUM(revenue_generated_by_managed_projects) AS total_revenue\nFROM current_senior_employees\nLEFT JOIN avg_performance_last_5years\nON id = employee_id\nGROUP BY employee_id\n```\n\nIt is the same example as the previous section. The only difference is that I did not use aliases (e.g., `a` and `b`) here. In this example, it is difficult to figure out the `email` column is coming from which table. Just because the column name is unique, you should not stop using aliases (especially when you join multiple tables).\nNow imagine if I used SELECT * in addition to not using aliases.\ntext\n\n```\nWITH current_senior_employees AS (\n    SELECT *\n    FROM employee\n    WHERE age>=45\n        AND is_current = true\n        AND years_in_company >= 6\n),\nperformance_last_5years AS (\n    SELECT *\n    FROM performance_review\n    WHERE year BETWEEN 2016 AND 2020\n)\nSELECT\n    ARBITRARY(first_name), \n    ARBITRARY(last_name), \n    ARBITRARY(email),    \n    SUM(num_of_managed_employees) AS total_num_managed_employees,\n    SUM(num_of_managed_projects) AS total_num_of_managed_projects,\n    SUM(revenue_generated_by_managed_projects) AS total_revenue\nFROM current_senior_employees\nLEFT JOIN avg_performance_last_5years\nON id = employee_id\nGROUP BY employee_id\n```\n\nUsing SELECT * and avoiding aliases even for a simple query can lead to big confusion.\nRemember, use aliases to make your query more readable and easier to understand.\n## No meaningless aliases\nStop using meaningless aliases like a, b, c, and so on. The next bad thing after not using aliases is to use meaningless aliases. It is very common among data engineers and scientists to use simple aliases like a and b when they join tables. I am not against using a and b for temporary ad-hoc queries, but I do not use them for long-term queries or pipelines. When you share a query with someone else or go back to your query after a long time, it is not easy to understand it with meaningless aliases. Again for super short queries like the previous example, it is not hard to find out what a and b refer to, but when the query becomes long, it takes too much of our short-term memory to understand the query and fix it when necessary. For example, in my query, I could use:\ntext\n\n```\nWITH current_senior_employees AS (\n    SELECT \n        id, \n        first_name, \n        last_name, \n        email\n    FROM employee\n    WHERE age>=45\n        AND is_current = true\n        AND years_in_company >= 6\n),\nperformance_last_5years AS (\n    SELECT \n        employee_id, \n        num_of_managed_employees, \n        num_of_managed_projects,\n        revenue_generated_by_managed_projects\n    FROM performance_review\n    WHERE year BETWEEN 2016 AND 2020\n)\nSELECT\n    ARBITRARY(employee.first_name), \n    ARBITRARY(employee.last_name), \n    ARBITRARY(employee.email),    \n    SUM(perform.num_of_managed_employees) \n        AS total_num_managed_employees,\n    SUM(perform.num_of_managed_projects) \n        AS total_num_of_managed_projects,\n    SUM(perform.revenue_generated_by_managed_projects) \n        AS total_revenue\nFROM current_senior_employees AS employee\nLEFT JOIN avg_performance_last_5years AS perform\nON employee.id = perform.employee_id\nGROUP BY perform.employee_id\n```\n\n## CTEs are friendly\nDon't be afraid to use CTEs. I have seen Data Engineers and Scientists who use complex nested subqueries to avoid using CTEs (for no obvious reason!). Let me show you how my example query becomes complex if I use subqueries instead of CTEs.\ntext\n\n```\nSELECT\n    ARBITRARY(employee.first_name), \n    ARBITRARY(employee.last_name), \n    ARBITRARY(employee.email),    \n    SUM(perform.num_of_managed_employees) \n        AS total_num_managed_employees,\n    SUM(perform.num_of_managed_projects) \n        AS total_num_of_managed_projects,\n    SUM(perform.revenue_generated_by_managed_projects) \n        AS total_revenue\nFROM (\n    SELECT \n        id, \n        first_name, \n        last_name, \n        email\n    FROM employee\n    WHERE age>=45\n        AND is_current = true\n        AND years_in_company >= 6\n) AS employee\nLEFT JOIN(\n    SELECT \n        employee_id, \n        num_of_managed_employees, \n        num_of_managed_projects,\n        revenue_generated_by_managed_projects\n    FROM performance_review\n    WHERE year BETWEEN 2016 AND 2020\n) AS perform\nON employee.id = perform.employee_id\nGROUP BY perform.employee_id\n```\n\nImagine how complex this could be if we have tens of joined tables (sometimes nested). Remember, there are multiple benefits of using CTEs:\n  1. CTEs are friendly to human short memory (more organized).\n  2. You can use a CTE multiple times in a query and make your query more organized (opposed to subqueries).\n\n\n## Base query using JINJA2\nJinja2 is very popular among data engineers and scientists to develop data pipelines. It enables them to make dynamic queries and compact large ETL queries via `Template()` function. Here I only focus on one of the hundreds of Jinja2 Template applications. My focus is to show you how Jinja2 Template can help you to write more clear SQL queries.\nIf you have multiple queries in your pipeline that use the same CTE or subquery, consider using defining a base query and replacing it in your queries via Jinja2. Here is an example of a pseudo query.\ntext\n\n```\nWITH cte1 AS (\n        SELECT ... \n        FROM table3\n        JOIN (    \n            SELECT \n                ...\n            FROM table1\n            JOIN table2\n            ON table1.col1 = table2.col2\n            WHERE ... \n            AND ... \n        ) AS table_x\n        ON ...\n        WHERE ...),\n    cte2 AS (\n        SELECT ... \n        FROM table4\n        JOIN (\n            SELECT \n                ...\n            FROM table1\n            JOIN table2\n            ON table1.col1 = table2.col2\n            WHERE ... \n            AND ...\n        ) AS table_x\n        ON ...\n        WHERE ...),\n    ) \n    SELECT \n        ... \n    FROM cte1 \n    JOIN cte2 \n    ON ... \n    WHERE ...\n```\n\nIf you look closely, you notice that the bolded subquery is repeated in both `cte1` and `cte2`. Using Jinja2 Template (for example, in Python), you can define a base query for the repeated query and replace it within the main query. You might argue that we can define a CTE instead of using the Jinja2 Template in this example. You are absolutely right! If there is only one query in your pipeline with such a subquery, using a CTE is a much better solution. Still, if you have multiple individual queries in your pipeline (for example, for different tasks) that use the same subquery, then you can use Jinja2 Template to share the same query between them.\nIf you don't know how to use Jinja2 Template, here is an example in Python.\ntext\n\n```\nfrom jinja2 import Template\n```\n\ntext\n\n```\nbase_query = \"\"\" \n    SELECT \n        ... \n    FROM table1\n    JOIN table2\n    ON table1.col1 = table2.col2\n    WHERE ... \n        AND ... \n\"\"\"\n```\n\ntext\n\n```\nmain_query = Template(\"\"\"\n    WITH cte1 AS (\n        SELECT ... \n        FROM table3\n        JOIN ({{subquery}}) AS table_x\n        ON ...\n        WHERE ...),\n    cte2 AS (\n        SELECT ... \n        FROM table4\n        JOIN ({{subquery}}) AS table_x\n        ON ...\n        WHERE ...),\n    ) \n    SELECT \n        ... \n    FROM cte1 \n    JOIN cte2 \n    ON ... \n    WHERE ...\n\"\"\").render(subquery=base_query)\n```\n\n## Some final (but important!!!) tips\nIn the end, I would like to have some crucial general advice for you on how to craft your queries or pipeline for better collaboration.\nThanks to the query optimization feature of most relational database systems, the query you write get optimized before it gets executed. Therefore, in many cases, you may write an inefficient query (for example, loading all columns in a CTE and then selecting columns). However, the optimizer finds an optimum query plan for execution, and the machine performance is still good. However, always remember, just because the optimizer is helping you to have a better performance, it does not mean that you can write queries any way you like. We must be considerate of people who collaborate with us now and in the future to maintain the code.\nFinally, if you think something might take your time at the query development stage, but it will save time later for those who read it, you must do it. For example, it might take you a little bit of time to find and use a proper alias name instead of random \"a\" or \"b,\" but it will save much time later for those who read it later (even yourself).\n* * *\nFollow me on [Medium](https://tamimi-naser.medium.com/) and [Twitter](https://twitter.com/TamimiNas) for the latest stories.\n## Register Now to Continue Reading\n### Unlock Towards Data Science with a Free Account\nAll articles on Towards Data Science are available to registered users. Create a free account today to access this article and thousands more.\nRegister for freeSign in to your account\n* * *\n![](https://assets.insightmediagroup.io/media/1787657191379_0jh99m.jpeg)\nWritten By\n## [Naser Tamimi](https://towardsdatascience.com/author/tamimi-naser/)\n[See all from Naser Tamimi](https://towardsdatascience.com/author/tamimi-naser/)\n[Data Science](https://towardsdatascience.com/tag/data-science/)[Programming](https://towardsdatascience.com/tag/programming/)[Software Development](https://towardsdatascience.com/tag/software-development/)[Sql](https://towardsdatascience.com/tag/sql/)[Technology](https://towardsdatascience.com/tag/technology/)\nShare This Article\n  * [](https://www.facebook.com/sharer/sharer.php?u=https%3A%2F%2Ftowardsdatascience.com%2Fcollaboration-friendly-sql-queries-ee7e14547a61%2F&title=Collaboration-Friendly%20SQL%20Queries)\n  * [](https://www.linkedin.com/shareArticle?mini=true&url=https%3A%2F%2Ftowardsdatascience.com%2Fcollaboration-friendly-sql-queries-ee7e14547a61%2F&title=Collaboration-Friendly%20SQL%20Queries)\n  * [](https://x.com/share?url=https%3A%2F%2Ftowardsdatascience.com%2Fcollaboration-friendly-sql-queries-ee7e14547a61%2F&text=Collaboration-Friendly%20SQL%20Queries)\n\n\nTowards Data Science is a community publication. Submit your insights to reach our global audience and earn through the TDS Author Payment Program.\n[Write for TDS](https://towardsdatascience.com/submissions/)\n## Related Articles\n  * [![](https://assets.insightmediagroup.io/media/wp-content/uploads/2024/11/1h3utjD4SEKbfGCUXotFbNA.png)](https://towardsdatascience.com/field-boundary-detection-in-satellite-imagery-using-the-sam2-model-b556aa97bf7a/)\n## [Field Boundary Detection in Satellite Imagery Using the SAM2 Model](https://towardsdatascience.com/field-boundary-detection-in-satellite-imagery-using-the-sam2-model-b556aa97bf7a/)\n[Data Science](https://towardsdatascience.com/category/data-science/)\nStep-by-Step Tutorial on Applying Segment Anything Model Version 2 to Satellite Imagery for Detecting and Exporting Field Boundaries in...\n[Mahyar Aboutalebi](https://towardsdatascience.com/author/mahyar.aboutalebi/)\nNovember 15, 202413 min read\n  * [![](https://assets.insightmediagroup.io/media/wp-content/uploads/2021/08/0L8KYA8WdqgETYHv4-scaled.jpg)](https://towardsdatascience.com/heres-how-openai-codex-will-revolutionize-programming-and-the-world-e8432aafc5f7/)\n## [Here's How OpenAI Codex Will Revolutionize Programming (and the World)](https://towardsdatascience.com/heres-how-openai-codex-will-revolutionize-programming-and-the-world-e8432aafc5f7/)\n[Artificial Intelligence](https://towardsdatascience.com/category/artificial-intelligence/)\n\"Codex gets close to what most of us really want from computers - we say what we want, and they do it.\" - Sam Altman\n[Alberto Romero](https://towardsdatascience.com/author/albertoromgar/)\nAugust 11, 202112 min read\n  * [![](https://assets.insightmediagroup.io/media/wp-content/uploads/2024/04/1o97lMptlIfPAzQFBQ4ckpw.png)](https://towardsdatascience.com/python-list-comprehension-is-not-just-syntactic-sugar-346463b4853d/)\n## [Python List Comprehension Is Not Just Syntactic Sugar](https://towardsdatascience.com/python-list-comprehension-is-not-just-syntactic-sugar-346463b4853d/)\n[Machine Learning](https://towardsdatascience.com/category/artificial-intelligence/machine-learning/)\n\"Pythonic\" is not a good reason. Why is the performance better? When not to use it?\n[Christopher Tao](https://towardsdatascience.com/author/christophertao/)\nApril 8, 20248 min read\n  * [![](https://assets.insightmediagroup.io/media/wp-content/uploads/2023/07/0svXZn_oiJEMRPrbO-scaled.jpg)](https://towardsdatascience.com/automatically-detecting-label-errors-in-datasets-with-cleanlab-e0a3ea5fb345/)\n## [Automatically Detecting Label Errors in Datasets with CleanLab](https://towardsdatascience.com/automatically-detecting-label-errors-in-datasets-with-cleanlab-e0a3ea5fb345/)\n[Artificial Intelligence](https://towardsdatascience.com/category/artificial-intelligence/)\nA Tale of AI and wrongly-classified Brazilian Federal Laws\n[João Pedro](https://towardsdatascience.com/author/joaopedro214/)\nJuly 22, 202310 min read\n  * [![](https://assets.insightmediagroup.io/media/wp-content/uploads/2020/10/06G1YjV6scScyno9v-scaled.jpg)](https://towardsdatascience.com/train-your-mind-to-think-recursively-in-5-steps-8f85c0e0eb81/)\n## [Train Your Mind to Think Recursively in 5 Steps](https://towardsdatascience.com/train-your-mind-to-think-recursively-in-5-steps-8f85c0e0eb81/)\n[Programming](https://towardsdatascience.com/category/programming/)\nHow to solve recursive problems easily?\n[Sara A. Metwalli](https://towardsdatascience.com/author/saraametwalli/)\nOctober 31, 20207 min read\n  * [![](https://assets.insightmediagroup.io/media/wp-content/uploads/2021/08/1wtW1hL2Og7usvxxzQsqU3A.png)](https://towardsdatascience.com/find-the-best-matching-distribution-for-your-data-effortlessly-bcc091aa08ab/)\n## [Find the Best-matching Distribution for Your Data Effortlessly](https://towardsdatascience.com/find-the-best-matching-distribution-for-your-data-effortlessly-bcc091aa08ab/)\n[Machine Learning](https://towardsdatascience.com/category/artificial-intelligence/machine-learning/)\nHow to find the best-matching statistical distributions for your data points - in an automated and easy way.\n[Tirthajyoti Sarkar](https://towardsdatascience.com/author/tirthajyoti/)\nAugust 17, 20215 min read\n  * [![](https://assets.insightmediagroup.io/media/wp-content/uploads/2021/04/1pnFJTvSMMznK_RCdK20nsg-scaled.jpeg)](https://towardsdatascience.com/3-beginner-mistakes-ive-made-in-my-data-science-career-a177f1cf751b/)\n## [3 Beginner Mistakes I've Made in My Data Science Career](https://towardsdatascience.com/3-beginner-mistakes-ive-made-in-my-data-science-career-a177f1cf751b/)\n[Artificial Intelligence](https://towardsdatascience.com/category/artificial-intelligence/)\nWriting this feels like career suicide\n[Arunn Thevapalan](https://towardsdatascience.com/author/arunnthevapalan/)\nApril 29, 20218 min read\n  * [![](https://assets.insightmediagroup.io/media/wp-content/uploads/2024/05/09iiDaMnE92OHLdVX-scaled.jpg)](https://towardsdatascience.com/breaking-down-state-of-the-art-ppo-implementations-in-jax-6f102c06c149/)\n## [A Practical Guide to Proximal Policy Optimization in JAX](https://towardsdatascience.com/breaking-down-state-of-the-art-ppo-implementations-in-jax-6f102c06c149/)\n[Programming](https://towardsdatascience.com/category/programming/)\nAll the tricks and details you wish you knew about PPO\n[Ryan Pégoud](https://towardsdatascience.com/author/ryanpegoud/)\nMay 1, 20248 min read\n  * [![](https://assets.insightmediagroup.io/media/wp-content/uploads/2022/03/1WSUQmP5sNF1nt-arH1DNKQ.jpeg)](https://towardsdatascience.com/shannon-information-theory-discovering-particles-of-information-ab2c136c6a25/)\n## [Shannon Information: Discovering Atoms of Communication](https://towardsdatascience.com/shannon-information-theory-discovering-particles-of-information-ab2c136c6a25/)\n[Data Science](https://towardsdatascience.com/category/data-science/)\nPhysical objects have atoms, information has bits. Claude Shannon believes that information, although intangible, can be quantified...\n[Casey Cheng](https://towardsdatascience.com/author/casey-cheng/)\nMarch 21, 202214 min read\n\n\n  * [YouTube](https://www.youtube.com/c/TowardsDataScience)\n  * [X](https://x.com/TDataScience)\n  * [LinkedIn](https://www.linkedin.com/company/towards-data-science/)\n  * [Threads](https://www.threads.net/@towardsdatascience)\n  * [Bluesky](https://bsky.app/profile/towardsdatascience.com)\n\n\n[](https://towardsdatascience.com/)\nYour home for data science and AI. The world's leading publication for data science, data analytics, data engineering, machine learning, and artificial intelligence professionals.\nSubscribe to Our Newsletter[Write For TDS](https://towardsdatascience.com/submissions/)•[About](https://towardsdatascience.com/about-towards-data-science-d691af11cc2f/)•[Advertise](https://contact.towardsdatascience.com/advertise-with-towards-data-science)•[Privacy Policy](https://towardsdatascience.com/privacy-policy/)•[Terms of Use](https://towardsdatascience.com/website-terms-of-use/)\n© Insight Media Group, LLC 2026•[The New Stack](https://thenewstack.io)•[roadmap.sh](https://roadmap.sh)•[Creator Network](https://insightmediagroup.io/creator-network)\n####  Recommended Articles \nClose\n  * [ ![](https://h030.towardsdatascience.com/rest/v2/contentStores/d7d3a4ab-7caf-4383-bbd2-fbf7fb4f1787/items/607686/image?etag=1782161464448&width=500&height=500) How Relevance Models Foreshadowed Transformers for NLP ](https://towardsdatascience.com/how-relevance-models-foreshadowed-transformers-for-nlp/ \"How Relevance Models Foreshadowed Transformers for NLP\")\n  * [ ![](https://h030.towardsdatascience.com/rest/v2/contentStores/d7d3a4ab-7caf-4383-bbd2-fbf7fb4f1787/items/607639/image?etag=1781250125848&width=500&height=500) Javascript Fatigue: HTMX Is All You Need to Build ChatGPT — Part 1 ](https://towardsdatascience.com/javascript-fatigue-you-dont-need-js-to-build-chatgpt/ \"Javascript Fatigue: HTMX Is All You Need to Build ChatGPT — Part 1\")\n  * [ ![](https://h030.towardsdatascience.com/rest/v2/contentStores/d7d3a4ab-7caf-4383-bbd2-fbf7fb4f1787/items/607930/image?etag=1782124566054&width=500&height=500) The Subset Sum Problem Solved in Linear Time for Dense Enough Inputs ](https://towardsdatascience.com/subset-sum-problem-solved-in-linear-time-for-dense-enough-inputs/ \"The Subset Sum Problem Solved in Linear Time for Dense Enough Inputs\")\n  * [ ![](https://h030.towardsdatascience.com/rest/v2/contentStores/d7d3a4ab-7caf-4383-bbd2-fbf7fb4f1787/items/3660/image?etag=1780176246070&width=500&height=500) Does Your Company Have a Data Strategy? ](https://towardsdatascience.com/does-your-company-have-a-data-strategy-e8944dbec4ae/ \"Does Your Company Have a Data Strategy?\")\n\n\n",
  "body_base_path": "attachments/d8ec7b320c8b/pages/",
  "body_markdown_path": "attachments/d8ec7b320c8b/pages/archived-body.md",
  "local_html": "attachments/d8ec7b320c8b/pages/archived-body.html",
  "body_source": "prior_capture"
}