USE (Transact-SQL)

Se aplica a:SQL ServerAzure SQL Managed InstanceAnalytics Platform System (PDW)Almacenamiento de Microsoft Fabric

Cambia el contexto de la base de datos al de la base de datos especificada o a la instantánea de base de datos.

Convenciones de sintaxis de Transact-SQL

Sintaxis

USE { database_name }   
[;]  

Argumentos

database_name
Es el nombre de la base de datos o instantánea de base de datos a la que se cambia el contexto de usuario. Los nombres de base de datos y de instantánea de base de datos deben cumplir las mismas reglas que los identificadores.

En Azure SQL Database, el parámetro de base de datos solo puede hacer referencia a la base de datos actual. Si se proporciona una base de datos distinta de la base de datos actual, la instrucción USE no cambia entre bases de datos y se devuelve el código de error 40508. Para cambiar de base de datos, debe conectarse directamente a la base de datos. La instrucción USE está marcada como no aplicable a SQL Database al inicio de esta página porque, aunque se puede tener la instrucción USE en un lote, esta no hace nada.

Comentarios

Cuando un inicio de sesión de SQL Server se conecta a SQL Server, el inicio de sesión se conecta automáticamente a su base de datos predeterminada y adquiere el contexto de seguridad de un usuario de la base de datos. Si no se ha creado ningún usuario de la base de datos para el inicio de sesión de SQL Server, el inicio de sesión se conecta como guest. Si el usuario de la base de datos no tiene permiso CONNECT en la base de datos, la instrucción USE no funcionará correctamente. Si no se ha asignado ninguna base de datos predeterminada al inicio de sesión, su base de datos predeterminada se establecerá en master.

USE se ejecuta en tiempo de compilación y de ejecución, y surte efecto inmediatamente. Por lo tanto, las instrucciones que aparecen en un lote después de la instrucción USE se ejecutan en la base de datos especificada.

Permisos

Requiere permiso CONNECT en la base de datos de destino.

Ejemplos

En el siguiente ejemplo se cambia el contexto de la base de datos al de la base de datos AdventureWorks2022.

USE AdventureWorks2022;  
GO  

Consulte también

CREATE LOGIN (Transact-SQL)
CREATE USER (Transact-SQL)
Entidades de seguridad (motor de base de datos)
CREATE DATABASE (Transact-SQL de SQL Server)
DROP DATABASE (Transact-SQL)
EXECUTE (Transact-SQL)