Cómo: Agregar referencias a proyectos de base de datos

Artículo
08/10/2011

Puede agregar varios tipos de referencias a los proyectos de base de datos para controlar diferentes situaciones. Por ejemplo, puede hacer referencia a otros proyectos en la misma solución o puede hacer referencia a la salida de otras soluciones. Se siguen procedimientos ligeramente diferentes para agregar diferentes tipos de referencias. Por ejemplo, para utilizar una referencia entre bases de datos, no solamente debe agregar la referencia sino que también debe definir una variable y un valor asociado para la base de datos, el servidor o ambos. Para obtener más información acerca de los tipos de referencias y cuándo se puede usar cada uno de ellos, vea Uso de referencias en proyectos de base de datos.

Para hacer referencia a objetos definidos en un proyecto de base de datos de la misma solución

Abra la solución que contiene el proyecto de base de datos al que desea agregar una referencia.
En el menú Proyecto, haga clic en Agregar referencia de base de datos.

Aparecerá el cuadro de diálogo Agregar referencia de base de datos.
Para agregar una referencia a un proyecto de base de datos, siga estos pasos:
1. Haga clic en Proyectos de la base de datos en la solución actual.
2. En la lista, haga clic en el proyecto de base de datos al que desea agregar una referencia.
Para definir una variable SETVAR para un servidor, siga estos pasos:
1. Haga clic en Definir variable del servidor.
2. En Nombre, escriba un nombre para la variable que representa el servidor.
3. En Valor, escriba el nombre del servidor que la variable representa.
Nota

No necesita definir una variable de servidor si hace referencia a un objeto de una base de datos que reside en el mismo servidor que la base de datos a la que agrega la referencia.

Para especificar una variable SETVAR para la base de datos a la que desea hacer referencia, siga estos pasos:

Active la casilla Definir variable de la base de datos.
Desactive la casilla Literal si está seleccionado.
En Nombre, escriba un nombre para la variable que representa la base de datos.
En Valor, escriba el nombre de la base de datos que la variable representa.

Importante
Si el proyecto de base de datos contiene objetos que hacen referencia explícitamente a objetos de otra base de datos, debe actualizar estas referencias para que usen las variables que acaba de definir. Si importó objetos de una base de datos que contiene referencias entre bases de datos, debe actualizar las referencias para resolver las advertencias que producen estas referencias explícitas entre bases de datos.

Si el proyecto de base de datos contiene objetos que hacen referencia explícitamente a objetos de otra base de datos, debe actualizar estas referencias para que usen las variables que acaba de definir. Si importó objetos de una base de datos que contiene referencias entre bases de datos, debe actualizar las referencias para resolver las advertencias que producen estas referencias explícitas entre bases de datos.

Para especificar un valor literal para la base de datos a la que desea hacer referencia, siga estos pasos:
1. Active la casilla Definir variable de la base de datos.
2. Active la casilla Literal.
3. En Valor, escriba el nombre de la base de datos a la que desea hacer referencia.
Nota

Puede especificar un literal en lugar de un par de variable y valor si el nombre de la base de datos siempre es el mismo en el entorno de implementación de destino. Por ejemplo, puede utilizar un literal con el valor "maestra" para los objetos definidos en la base de datos "maestra".
Si el proyecto al que se hace referencia puede hacer referencia a su vez a otro proyecto, puede activar la casilla Suprimir errores causados por referencias no resueltas en el proyecto al que se hace referencia. No es probable que los errores del proyecto al que se hace referencia provoquen errores en el proyecto actual. Por tanto, puede optar por omitirlos.
Si no desea actualizar los objetos y scripts, desactive la casilla Actualizar las definiciones y scripts de los objetos de esquema existentes para que utilicen las variables de referencia de la base de datos y haga clic en Aceptar.

La referencia se agrega al proyecto de base de datos; no es necesario realizar ningún otro paso en este procedimiento.
Si desea actualizar los objetos y scripts, active la casilla Actualizar las definiciones y scripts de los objetos de esquema existentes para que utilicen las variables de referencia de la base de datos y haga clic en Aceptar.

Aparece el cuadro de diálogo Obtener vista previa de cambios - Cambiar el nombre del servidor o de la base de datos.
(Opcional) Desactive la casilla situada junto a uno o más de los cambios si no desea que se aplique el cambio.
(Opcional) Haga clic en cualquier cambio para mostrar sus detalles en el recuadro Obtener vista previa de los cambios.
Haga clic en Aplicar para actualizar los objetos y scripts que especificó.

La referencia se agrega al proyecto de base de datos y los objetos y scripts que especificó se modifican para utilizar las variables SETVAR en lugar de los nombres de servidores y bases de datos.

Para hacer referencia a los objetos que se definen en la salida de compilación (archivo .dbschema) de otro proyecto de base de datos

Abra la solución que contiene el proyecto de base de datos al que desea agregar una referencia.
En el menú Proyecto, haga clic en Agregar referencia de base de datos.

Aparecerá el cuadro de diálogo Agregar referencia de base de datos.
Para agregar una referencia a un metarchivo, siga estos pasos:
1. Haga clic en Metarchivo de proyecto de base de datos (.dbmeta) o esquema (.dbschema).
2. En el cuadro, escriba la ruta de acceso y el nombre del archivo de esquema o haga clic en Examinar para especificar el archivo de esquema para el que desea agregar una referencia.
Para definir una variable SETVAR para un servidor, siga estos pasos:
1. Haga clic en Definir variable del servidor.
2. En Nombre, escriba un nombre para la variable que representa el servidor.
3. En Valor, escriba el nombre del servidor que la variable representa.
Nota

No necesita definir una variable de servidor si hace referencia a un objeto de una base de datos que reside en el mismo servidor que la base de datos a la que agrega la referencia.

Para especificar una variable SETVAR para la base de datos a la que desea hacer referencia, siga estos pasos:

Active la casilla Definir variable de la base de datos.
Desactive la casilla Literal si está seleccionado.
En Nombre, escriba un nombre para la variable que representa la base de datos.
En Valor, escriba el nombre de la base de datos que la variable representa.

Para especificar un valor literal para la base de datos a la que desea hacer referencia, siga estos pasos:
1. Active la casilla Definir variable de la base de datos.
2. Active la casilla Literal.
3. En Valor, escriba el nombre de la base de datos a la que desea hacer referencia.
Nota

Puede especificar un literal en lugar de un par de variable y valor si el nombre de la base de datos siempre es el mismo en el entorno de implementación de destino. Por ejemplo, puede utilizar un literal con el valor "maestra" para los objetos definidos en la base de datos "maestra".
Si el proyecto al que se hace referencia puede hacer referencia a su vez a otro proyecto, puede activar la casilla Suprimir errores causados por referencias no resueltas en el proyecto al que se hace referencia. No es probable que los errores del proyecto al que se hace referencia provoquen errores en el proyecto actual. Por tanto, puede optar por omitirlos.
Si no desea actualizar los objetos y scripts, desactive la casilla Actualizar las definiciones y scripts de los objetos de esquema existentes para que utilicen las variables de referencia de la base de datos y haga clic en Aceptar.

La referencia se agrega al proyecto de base de datos; no es necesario realizar ningún otro paso en este procedimiento.
Si desea actualizar los objetos y scripts, active la casilla Actualizar las definiciones y scripts de los objetos de esquema existentes para que utilicen las variables de referencia de la base de datos y haga clic en Aceptar.

Aparece el cuadro de diálogo Obtener vista previa de cambios - Cambiar el nombre del servidor o de la base de datos.
(Opcional) Desactive la casilla situada junto a uno o más de los cambios si no desea que se aplique el cambio.
(Opcional) Puede hacer clic en cualquier cambio para mostrar sus detalles en el recuadro Obtener vista previa de cambios.
Haga clic en Aplicar para actualizar los objetos de esquema y scripts que especificó.

La referencia se agrega al proyecto de base de datos y los objetos y scripts que especificó se modifican para utilizar las variables SETVAR en lugar de los nombres de servidores y bases de datos.

Importante
Si el proyecto de base de datos contiene objetos que hacen referencia explícitamente a objetos de otra base de datos, debe actualizar estas referencias para que usen las variables que acaba de definir. Si importó objetos de una base de datos que contiene referencias entre bases de datos, debe actualizar las referencias para resolver las advertencias que producen estas referencias explícitas entre bases de datos.

Para incluir el contenido de un proyecto de base de datos en la solución actual como parte del proyecto de referencia

Abra la solución que contiene el proyecto de base de datos al que desea agregar una referencia.
En el menú Proyecto, haga clic en Agregar referencia de base de datos.

Aparecerá el cuadro de diálogo Agregar referencia de base de datos.
Haga clic en Proyectos de la base de datos en la solución actual, haga clic en el proyecto de base de datos al que desea agregar una referencia y haga clic en Aceptar.

La referencia se agrega al proyecto de base de datos. Al implementar el proyecto al que agregó la referencia, el proyecto que especificó en la referencia se trata como parte del proyecto que está implementando.

Para agregar una referencia a un proyecto de SQLCLR en la solución actual

Abra la solución que contiene el proyecto de base de datos al que desea agregar una referencia.
Haga clic en la opción Agregar referencia del menú Proyecto.

Aparecerá el cuadro de diálogo Agregar referencia.
Haga clic en la pestaña Proyectos, si no está ya activa.
Haga clic en el nombre del proyecto de Common Language Runtime (CLR) de SQL al que desea hacer referencia y, a continuación, haga clic en Aceptar.

La referencia se agrega al proyecto de base de datos.
En el Explorador de soluciones, haga clic con el botón secundario del mouse en la referencia y, a continuación, haga clic en Propiedades.

Aparece la ventana Propiedades.
Actualice las propiedades de la referencia para especificar los detalles de la instrucción CREATE ASSEMBLY que se genera al compilar el proyecto de base de datos.
En el menú Archivo, haga clic en Guardar todo.

Para agregar una referencia a un ensamblado de SQLCLR

Abra la solución que contiene el proyecto de base de datos al que desea agregar una referencia.
Haga clic en la opción Agregar referencia del menú Proyecto.

Aparecerá el cuadro de diálogo Agregar referencia.
Haga clic en la pestaña Examinar, si no está ya activa.
Especifique el ensamblado (.dll) al que desea hacer referencia y, a continuación, haga clic en Aceptar.

La referencia se agrega al proyecto de base de datos.
En el Explorador de soluciones, haga clic con el botón secundario del mouse en la referencia y, a continuación, haga clic en Propiedades.

Aparece la ventana Propiedades.
Actualice las propiedades de la referencia para especificar los detalles de la instrucción CREATE ASSEMBLY que se genera al compilar el proyecto de base de datos.
En el menú Archivo, haga clic en Guardar todo.