sql-docs
Technical documentation for Microsoft SQL Server, tools such as SQL Server Management Studio (SSMS) , SQL Server Data Tools (SSDT) etc.
Top Related Projects
Open source documentation of Microsoft Azure
Mirror of the official PostgreSQL GIT repository. Note that this is just a *mirror* - we don't work with pull requests on github. To contribute, please see https://wiki.postgresql.org/wiki/Submitting_a_Patch
MySQL Server, the world's most popular open source database, and MySQL Cluster, a real-time, open source transactional database.
CockroachDB — the cloud native, distributed SQL database designed for high availability, effortless scale, and control over data placement.
MariaDB server is a community developed fork of MySQL server. Started by core members of the original MySQL team, MariaDB actively works with outside developers to deliver the most featureful, stable, and sanely licensed open SQL server in the industry.
The MongoDB Database
Quick Overview
MicrosoftDocs/sql-docs is the official GitHub repository for Microsoft SQL Server documentation. It contains comprehensive documentation for SQL Server, Azure SQL Database, and related products. This repository allows community contributions, enabling users to suggest improvements or corrections to the official documentation.
Pros
- Comprehensive and up-to-date documentation for Microsoft SQL products
- Open for community contributions, allowing for rapid updates and improvements
- Well-organized structure, making it easy to navigate and find specific information
- Includes documentation for various SQL Server versions and related tools
Cons
- Large repository size may be overwhelming for new contributors
- Some sections may require frequent updates due to rapidly evolving products
- Contribution process might be intimidating for first-time contributors
- Occasional inconsistencies in formatting or style across different sections
Note: As this is a documentation repository and not a code library, the code examples and getting started instructions sections have been omitted.
Competitor Comparisons
Open source documentation of Microsoft Azure
Pros of azure-docs
- Broader scope, covering all Azure services and technologies
- More frequent updates due to the rapidly evolving nature of Azure
- Extensive community contributions and feedback
Cons of azure-docs
- Can be overwhelming due to the vast amount of information
- May have more inconsistencies across different service documentations
- Potentially steeper learning curve for newcomers to cloud computing
Code Comparison
azure-docs (Azure CLI example):
az group create --name myResourceGroup --location eastus
az vm create --resource-group myResourceGroup --name myVM --image Ubuntu2204
sql-docs (T-SQL example):
CREATE DATABASE MyDatabase;
USE MyDatabase;
CREATE TABLE MyTable (ID int, Name varchar(50));
Both repositories provide comprehensive documentation for their respective domains. sql-docs focuses specifically on SQL Server and related technologies, offering in-depth coverage of database concepts and T-SQL. azure-docs, on the other hand, encompasses a wider range of cloud services and technologies, including databases, but also covering areas like networking, security, and AI.
While sql-docs may be more focused and easier to navigate for database-specific information, azure-docs offers a more holistic view of cloud computing and integration with various services. The choice between the two depends on the specific needs of the user and their area of focus within the Microsoft ecosystem.
Mirror of the official PostgreSQL GIT repository. Note that this is just a *mirror* - we don't work with pull requests on github. To contribute, please see https://wiki.postgresql.org/wiki/Submitting_a_Patch
Pros of postgres
- Open-source project with a large community of contributors
- More frequent updates and releases
- Comprehensive codebase including server implementation
Cons of postgres
- Less structured documentation compared to sql-docs
- Steeper learning curve for new contributors
- Primarily C-based codebase, which may be less accessible for some developers
Code Comparison
postgres:
/* in src/backend/utils/adt/datetime.c */
Datum
date_eq(PG_FUNCTION_ARGS)
{
DateADT date1 = PG_GETARG_DATEADT(0);
DateADT date2 = PG_GETARG_DATEADT(1);
PG_RETURN_BOOL(date1 == date2);
}
sql-docs:
-- in T-SQL documentation
SELECT OrderDate, COUNT(*)
FROM Sales.SalesOrderHeader
WHERE YEAR(OrderDate) = 2011
GROUP BY OrderDate
HAVING COUNT(*) > 10
ORDER BY OrderDate;
The postgres example shows C code implementing a date comparison function, while the sql-docs example demonstrates T-SQL query syntax for data retrieval and aggregation. This highlights the difference in focus between the two repositories: postgres contains the actual database engine implementation, while sql-docs provides documentation and usage examples for SQL Server.
MySQL Server, the world's most popular open source database, and MySQL Cluster, a real-time, open source transactional database.
Pros of mysql-server
- Open-source project with a large community of contributors
- More frequent updates and releases
- Includes the actual server source code, allowing for deeper understanding and customization
Cons of mysql-server
- Less comprehensive documentation compared to sql-docs
- May be more challenging for beginners to navigate and understand
- Focuses primarily on MySQL, while sql-docs covers multiple Microsoft SQL products
Code Comparison
mysql-server:
bool Item_func_in::val_bool() {
if (exec_ctx && exec_ctx->is_error()) return false;
if (arg_count == 0) return false;
Item *first_expr = args[0];
if (first_expr->type() == Item::SUBSELECT_ITEM) {
// ... (additional code)
}
}
sql-docs (example T-SQL code from documentation):
CREATE PROCEDURE dbo.uspGetEmployeeManagers
@EmployeeID int
AS
SET NOCOUNT ON;
WITH EMP_CTE(EmployeeID, ManagerID, FirstName, LastName, Title, EmployeeLevel) AS
(
-- ... (additional code)
)
Note: The code comparison is limited as sql-docs primarily contains documentation rather than source code.
CockroachDB — the cloud native, distributed SQL database designed for high availability, effortless scale, and control over data placement.
Pros of cockroach
- Open-source distributed SQL database with horizontal scalability
- Built-in support for geo-partitioning and multi-region deployments
- Strong consistency and high availability features
Cons of cockroach
- Steeper learning curve compared to traditional SQL databases
- Limited ecosystem and third-party tool support
- Potentially higher resource requirements for small-scale deployments
Code comparison
sql-docs (T-SQL):
CREATE TABLE Users (
UserID INT PRIMARY KEY,
Username NVARCHAR(50) NOT NULL,
Email NVARCHAR(100) UNIQUE
);
cockroach (CockroachDB SQL):
CREATE TABLE Users (
UserID INT PRIMARY KEY,
Username STRING(50) NOT NULL,
Email STRING(100) UNIQUE,
INDEX (Email)
);
The code examples show similar syntax for creating tables, with minor differences:
- CockroachDB uses
STRING
instead ofNVARCHAR
- CockroachDB explicitly defines an index on the
Email
column - Both databases support primary keys and unique constraints
While sql-docs provides comprehensive documentation for Microsoft SQL Server, cockroach offers an actual database implementation with a focus on distributed systems and scalability. sql-docs is more suitable for users of Microsoft's SQL Server, while cockroach caters to those seeking a cloud-native, distributed SQL solution.
MariaDB server is a community developed fork of MySQL server. Started by core members of the original MySQL team, MariaDB actively works with outside developers to deliver the most featureful, stable, and sanely licensed open SQL server in the industry.
Pros of server
- Open-source project with active community development
- More frequent updates and releases
- Broader platform support (Linux, Windows, macOS)
Cons of server
- Less comprehensive documentation compared to sql-docs
- Smaller ecosystem and third-party tool support
- Potentially steeper learning curve for newcomers
Code Comparison
MariaDB server:
CREATE TABLE users (
id INT AUTO_INCREMENT PRIMARY KEY,
username VARCHAR(50) NOT NULL,
email VARCHAR(100) NOT NULL,
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
SQL Server (from sql-docs):
CREATE TABLE users (
id INT IDENTITY(1,1) PRIMARY KEY,
username NVARCHAR(50) NOT NULL,
email NVARCHAR(100) NOT NULL,
created_at DATETIME2 DEFAULT GETDATE()
);
The code examples show similar syntax for creating tables, with minor differences:
- MariaDB uses
AUTO_INCREMENT
while SQL Server usesIDENTITY(1,1)
- MariaDB uses
VARCHAR
, SQL Server usesNVARCHAR
for Unicode support - Different default timestamp functions:
CURRENT_TIMESTAMP
vsGETDATE()
Both repositories offer valuable resources for their respective database systems. server provides an open-source solution with frequent updates, while sql-docs offers comprehensive documentation for Microsoft SQL Server.
The MongoDB Database
Pros of mongo
- Open-source project with active community contributions
- Flexible schema design for handling diverse data structures
- Native support for scalability and high-performance operations
Cons of mongo
- Less comprehensive documentation compared to sql-docs
- Steeper learning curve for developers familiar with relational databases
- Limited support for complex joins and transactions
Code Comparison
mongo:
db.users.insertOne({
name: "John Doe",
age: 30,
email: "john@example.com"
})
sql-docs:
INSERT INTO Users (Name, Age, Email)
VALUES ('John Doe', 30, 'john@example.com');
The mongo example demonstrates the flexibility of document-based storage, allowing for easy insertion of structured data without predefined schemas. The sql-docs example showcases the traditional relational database approach with a predefined table structure.
Both repositories serve different purposes: mongo is the core database engine, while sql-docs is primarily documentation. This makes a direct comparison challenging in some aspects. However, mongo offers more hands-on development opportunities, while sql-docs provides extensive guidance for Microsoft SQL Server users.
Convert designs to code with AI
Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.
Try Visual CopilotREADME
Index
Microsoft Open Source Code of Conduct
This project has adopted the Microsoft Open Source Code of Conduct. For more information, see the Code of Conduct FAQ, or contact opencode@microsoft.com with any additional questions or comments.
Microsoft SQL Server Technical Documentation
You've found the GitHub repository that houses the source for SQL Server technical documentation.
Contribute to documentation
Anyone can submit changes to the SQL Server documentation. For more information, see How to contribute to SQL Server Documentation.
Minor corrections
Minor corrections or clarifications that you submit for documentation and code examples in this repo are covered by the Terms of Use.
Larger submissions
If you submit a pull request with new content or significant changes to documentation or code examples and you are not an employee of Microsoft, we'll send a comment in GitHub asking you to submit an online Contribution License Agreement (CLA). We will need you to complete the online form before we can accept your pull request.
Next steps
Explore the following resources:
Top Related Projects
Open source documentation of Microsoft Azure
Mirror of the official PostgreSQL GIT repository. Note that this is just a *mirror* - we don't work with pull requests on github. To contribute, please see https://wiki.postgresql.org/wiki/Submitting_a_Patch
MySQL Server, the world's most popular open source database, and MySQL Cluster, a real-time, open source transactional database.
CockroachDB — the cloud native, distributed SQL database designed for high availability, effortless scale, and control over data placement.
MariaDB server is a community developed fork of MySQL server. Started by core members of the original MySQL team, MariaDB actively works with outside developers to deliver the most featureful, stable, and sanely licensed open SQL server in the industry.
The MongoDB Database
Convert designs to code with AI
Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.
Try Visual Copilot