Lesson 1: Create and query database objects
Applies to: SQL Server (all supported versions) Azure SQL Database Azure SQL Managed Instance Analytics Platform System (PDW)
This lesson shows you how to create a database, create a table in the database, and then access and change the data in the table. Because this lesson is an introduction to using Transact-SQL, it does not use or describe the many options that are available for these statements.
Transact-SQL statements can be written and submitted to the Database Engine in the following ways:
By using SQL Server Management Studio. This tutorial assumes that you are using Management Studio, but you can also use Management Studio Express, which is available as a free download from the Microsoft Download Center.
By using the sqlcmd utility.
By connecting from an application that you create.
The code executes on the Database Engine in the same way and with the same permissions, regardless of how you submit the code statements.
To run Transact-SQL statements in Management Studio, open Management Studio and connect to an instance of the SQL Server Database Engine.
To complete this tutorial, you need SQL Server Management Studio and access to a SQL Server instance.
- Install SQL Server Management Studio.
If you don't have a SQL Server instance, create one. To create one, select your platform from the following links. If you choose SQL Authentication, use your SQL Server login credentials.
Create a database
Like many Transact-SQL statements, the
CREATE DATABASE statement has a required parameter: the name of the database.
CREATE DATABASE also has many optional parameters, such as the disk location where you want to put the database files. When you execute
CREATE DATABASE without the optional parameters, SQL Server uses default values for many of these parameters.
In a Query Editor window, type but do not execute the following code:
CREATE DATABASE TestData GO
Use the pointer to select the words
CREATE DATABASE, and then press F1. The
CREATE DATABASEtopic in SQL Server Books Online should open. You can use this technique to find the complete syntax for
CREATE DATABASEand for the other statements that are used in this tutorial.
In Query Editor, press F5 to execute the statement and create a database named
When you create a database, SQL Server makes a copy of the model database, and renames the copy to the database name. This operation should only take several seconds, unless you specify a large initial size of the database as an optional parameter.
The keyword GO separates statements when more than one statement is submitted in a single batch. GO is optional when the batch contains only one statement.
Create a Table
Applies to: SQL Server Azure SQL Database Azure Synapse Analytics Analytics Platform System (PDW)
To create a table, you must provide a name for the table, and the names and data types of each column in the table. It is also a good practice to indicate whether null values are allowed in each column. To create a table, you must have the
CREATE TABLE permission, and the
ALTER SCHEMA permission on the schema that will contain the table. The
db_ddladmin fixed database role has these permissions.
Most tables have a primary key, made up of one or more columns of the table. A primary key is always unique. The Database Engine will enforce the restriction that any primary key value cannot be repeated in the table.
For a list of data types and links for a description of each, see Data Types (Transact-SQL).
The Database Engine can be installed as case sensitive or non-case sensitive. If the Database Engine is installed as case sensitive, object names must always have the same case. For example, a table named OrderData is a different table from a table named ORDERDATA. If the Database Engine is installed as non-case sensitive, those two table names are considered to be the same table, and that name can only be used one time.
Switch the Query Editor connection to the TestData database
In a Query Editor window, type and execute the following code to change your connection to the
USE TestData GO
Create the table
In a Query Editor window, type and execute the following code to create a table named
Products. The columns in the table are named
ProductID column is the primary key of the table.
varchar(max) are all data types. Only the
ProductionDescription columns can have no data when a row is inserted or changed. This statement contains an optional element (
dbo.) called a schema. The schema is the database object that owns the table. If you are an administrator,
dbo is the default schema.
dbo stands for database owner.
CREATE TABLE dbo.Products (ProductID int PRIMARY KEY NOT NULL, ProductName varchar(25) NOT NULL, Price money NULL, ProductDescription varchar(max) NULL) GO
Insert and update data in a table
Now that you have created the Products table, you are ready to insert data into the table by using the INSERT statement. After the data is inserted, you will change the content of a row by using an UPDATE statement. You will use the WHERE clause of the UPDATE statement to restrict the update to a single row. The four statements will enter the following data.
|75||Tire Bar||Tool for changing tires.|
|3000||3 mm Bracket||0.52|
The basic syntax is: INSERT, table name, column list, VALUES, and then a list of the values to be inserted. The two hyphens in front of a line indicate that the line is a comment and the text will be ignored by the compiler. In this case, the comment describes a permissible variation of the syntax.
Insert data into a table
- Execute the following statement to insert a row into the
Productstable that was created in the previous task.
-- Standard syntax INSERT dbo.Products (ProductID, ProductName, Price, ProductDescription) VALUES (1, 'Clamp', 12.48, 'Workbench clamp') GO
If the insert succeeds, proceed to the next step.
If the insert fails, it may be because the
Product table already has a row with that product ID in it. To proceed, delete all the rows in the table and repeat the preceding step.
TRUNCATE TABLE deletes all the rows in the table.
Run the following command to delete all the rows in the table:
TRUNCATE TABLE TestData.dbo.Products; GO
After you truncate the table, repeat the
INSERT command in this step.
- The following statement shows how you can change the order in which the parameters are provided by switching the placement of the
ProductNamein both the field list (in parentheses) and in the values list.
-- Changing the order of the columns INSERT dbo.Products (ProductName, ProductID, Price, ProductDescription) VALUES ('Screwdriver', 50, 3.17, 'Flat head') GO
- The following statement demonstrates that the names of the columns are optional, as long as the values are listed in the correct order. This syntax is common but is not recommended because it might be harder for others to understand your code.
NULLis specified for the
Pricecolumn because the price for this product is not yet known.
-- Skipping the column list, but keeping the values in order INSERT dbo.Products VALUES (75, 'Tire Bar', NULL, 'Tool for changing tires.') GO
- The schema name is optional as long as you are accessing and changing a table in your default schema. Because the
ProductDescriptioncolumn allows null values and no value is being provided, the
ProductDescriptioncolumn name and value can be dropped from the statement completely.
-- Dropping the optional dbo and dropping the ProductDescription column INSERT Products (ProductID, ProductName, Price) VALUES (3000, '3 mm Bracket', 0.52) GO
Update the products table
Type and execute the following
UPDATE statement to change the
ProductName of the second product from
Flat Head Screwdriver.
UPDATE dbo.Products SET ProductName = 'Flat Head Screwdriver' WHERE ProductID = 50 GO
Read data from a table
Use the SELECT statement to read the data in a table. The SELECT statement is one of the most important Transact-SQL statements, and there are many variations in the syntax. For this tutorial, you will work with five simple versions.
Read the data in a table
- Type and execute the following statements to read the data in the
-- The basic syntax for reading data from a single table SELECT ProductID, ProductName, Price, ProductDescription FROM dbo.Products GO
- You can use an asterisk (
*) to select all the columns in the table. The asterisk is for ad hoc queries. In permanent code, provide the column list so that the statement returns the predicted columns, even if a new column is added to the table later.
-- Returns all columns in the table -- Does not use the optional schema, dbo SELECT * FROM Products GO
- You can omit columns that you do not want to return. The columns will be returned in the order that they are listed.
-- Returns only two of the columns from the table SELECT ProductName, Price FROM dbo.Products GO
- Use a
WHEREclause to limit the rows that are returned to the user.
-- Returns only two of the records in the table SELECT ProductID, ProductName, Price, ProductDescription FROM dbo.Products WHERE ProductID < 60 GO
- You can work with the values in the columns as they are returned. The following example performs a mathematical operation on the
Pricecolumn. Columns that have been changed in this way will not have a name unless you provide one by using the
-- Returns ProductName and the Price including a 7% tax -- Provides the name CustomerPays for the calculated column SELECT ProductName, Price * 1.07 AS CustomerPays FROM dbo.Products GO
Useful functions in a SELECT Statement
For information about some functions that you can use to work with data in SELECT statements, see the following topics:
Create views and stored procedures
A view is a stored SELECT statement, and a stored procedure is one or more Transact-SQL statements that execute as a batch.
Views are queried like tables and do not accept parameters. Stored procedures are more complex than views. Stored procedures can have both input and output parameters and can contain statements to control the flow of the code, such as IF and WHILE statements. It is good programming practice to use stored procedures for all repetitive actions in the database.
For this example, you will use CREATE VIEW to create a view that selects only two of the columns in the Products table. Then, you will use CREATE PROCEDURE to create a stored procedure that accepts a price parameter and returns only those products that cost less than the specified parameter value.
Create a view
Execute the following statement to create a view that executes a select statement, and returns the names and prices of our products to the user.
CREATE VIEW vw_Names AS SELECT ProductName, Price FROM Products; GO
Test the view
Views are treated just like tables. Use a
SELECT statement to access a view.
SELECT * FROM vw_Names; GO
Create a stored procedure
The following statement creates a stored procedure name
pr_Names, accepts an input parameter named
@VarPrice of data type
money. The stored procedure prints the statement
Products less than concatenated with the input parameter that is changed from the
money data type into a
varchar(10) character data type. Then, the procedure executes a
SELECT statement on the view, passing the input parameter as part of the
WHERE clause. This returns all products that cost less than the input parameter value.
CREATE PROCEDURE pr_Names @VarPrice money AS BEGIN -- The print statement returns text to the user PRINT 'Products less than ' + CAST(@VarPrice AS varchar(10)); -- A second statement starts here SELECT ProductName, Price FROM vw_Names WHERE Price < @VarPrice; END GO
Test the stored procedure
To test the stored procedure, type and execute the following statement. The procedure should return the names of the two products entered into the
Products table in Lesson 1 with a price that is less than
EXECUTE pr_Names 10.00; GO
The next article teaches you how to configure permissions on database objects. The objects created in lesson 1 will also be used in lesson 2.
Go to the next article to learn more: