Esta documentación está archivada y no tiene mantenimiento.

Herramienta Registro de SQL Server para ASP.NET (Aspnet_regsql.exe)

La herramienta Registro de SQL Server para ASP.NET se utiliza para crear una base de datos de Microsoft SQL Server que van a utilizar los proveedores de SQL Server en ASP.NET, o bien, para agregar o quitar opciones de una base de datos existente. El archivo Aspnet_regsql.exe está ubicado en la carpeta [unidad:]\WINDOWS\Microsoft.NET\Framework\númeroDeVersión en el servidor Web.

Si se ejecuta sin argumentos de línea de comandos, Aspnet_regsql.exe ejecuta un asistente que le guiará en el proceso de especificar la información de conexión para la instalación de SQL Server y en el proceso de instalar o quitar los elementos de base de datos de las características de suscripción, administración de funciones, perfiles, personalización de elementos Web y supervisión de estado. (El asistente no incluye la configuración del estado de sesión ni de la dependencia de caché de SQL.) Aspnet_regsql.exe se puede ejecutar como herramienta de línea de comandos para especificar los elementos de base de datos de determinadas funciones que se van a agregar o quitar, mediante las opciones que figuran en la siguiente tabla.

Sintaxis

Aspnet_regsql.exe <options>

Opciones de conexión de SQL

Opción Descripción

-?

Imprime el texto de la Ayuda de Aspnet_regsql.exe en la ventana de comandos.

-W

Ejecuta la herramienta en modo de asistente. Éste es el valor predeterminado si no se especifica ningún argumento de la línea de comandos.

-C <connection string>

Especifica la cadena de conexión con el equipo que ejecuta SQL Server y en el que se va a instalar o ya está instalada la base de datos. Esta opción no es necesaria si sólo especifica el servidor (-S) y la información de inicio de sesión (-U y -P o -E).

-S <server>

Especifica el nombre del equipo que ejecuta SQL Server y en el que se va a instalar o ya está instalada la base de datos.

-U <login ID>

Identificador de usuario de SQL Server con el que se va a iniciar sesión. Esta opción también requiere la opción de contraseña (-P). Esta opción no es necesaria si utiliza las credenciales de Windows para la autenticación (-E).

-P <password>

Contraseña de SQL Server con la que se va a iniciar sesión. Esta opción también requiere la opción de identificador de usuario (-U). Esta opción no es necesaria si utiliza las credenciales de Windows para la autenticación (-E).

-E

Para la autenticación se utilizan las credenciales de Windows del usuario que ha iniciado la sesión actual.

-sqlexportlonly <filename>

Genera un archivo de secuencias de comandos SQL que se puede utilizar para agregar o quitar las características especificadas. No se realizan las acciones especificadas.

Opciones de los servicios de aplicaciones

Opción Descripción

-A all|m|r|p|c|w

Agrega compatibilidad para uno o varios servicios de aplicaciones ASP.NET. Los identificadores de servicio se pueden especificar juntos o separados. Se utilizan los siguientes identificadores para los servicios de aplicaciones ASP.NET:

all: todos los servicios, incluyendo las tablas comunes y los procedimientos almacenados compartidos por los servicios.

m: suscripción

r: administrador de funciones

p: perfil

c: personalización de elementos Web

w: eventos Web

-R all|m|r|p|c|w

Quita compatibilidad con uno o varios servicios de aplicaciones. Los identificadores de servicio se pueden especificar juntos o separados. Se utilizan los siguientes identificadores para los servicios de aplicaciones ASP.NET:

all: todos los servicios, incluyendo las tablas comunes y los procedimientos almacenados compartidos por los servicios.

m: suscripción

r: administrador de funciones

p: perfil

c: personalización de elementos Web

w: eventos Web

-Q

Ejecuta la herramienta en modo no interactivo y no solicita la confirmación antes de quitar un servicio de aplicación.

-d <database>

Especifica el nombre de la base de datos que se va a crear o modificar para su uso con los servicios de aplicaciones. Si no se especifica la base de datos, se utilizará el nombre de base de datos predeterminado, "aspnetdb".

Opciones de la dependencia de caché de SQL (para Microsoft SQL Server 7.0, Microsoft SQL Server 2000 y SQL Server 2005)

Opción Descripción

-d <database>

Especifica el nombre de la base de datos que se va a utilizar con la dependencia de caché de SQL. De manera opcional, la base de datos puede especificarse utilizando la opción de cadena de conexión, -C.

-ed

Habilita una base de datos para la dependencia de caché de SQL.

-dd

Deshabilita una base de datos para la dependencia de caché de SQL.

-et

Habilita una tabla para la dependencia de caché de SQL. La opción -t también debe incluirse en la cadena de parámetro.

-dt

Deshabilita una tabla para la dependencia de caché de SQL. La opción -t debe incluirse en la cadena de parámetro.

-t <table>

Especifica el nombre de la tabla que se va a habilitar o deshabilitar para su uso con la dependencia de caché de SQL. Esta opción debe utilizarse junto con la opción -et o -dt.

-lt

Muestra todas las tablas habilitadas para la dependencia de caché de SQL.

Opciones de estado de sesión

Opción Descripción

-d <database>

Especifica el nombre de la base de datos en la que se va a almacenar el estado de sesión. Esta opción debe utilizarse si el valor de -sstype se establece en "c".

-ssadd

Agrega compatibilidad para el modo de estado de sesión de SQL Server.

-ssremove

Quita la compatibilidad para el modo de estado de sesión de SQL Server.

-sstype t|p|c

Especifica el tipo de estado de sesión que se va a utilizar:

t: temporal. Los datos del estado de sesión se almacenan en la base de datos tempdb de SQL Server. Los procedimientos almacenados para administrar el estado de sesión se instalan en la base de datos ASPState de SQL Server. No se conservan los datos si se reinicia SQL. Éste es el valor predeterminado.

p: guardado. Los datos del estado de sesión y los procedimientos almacenados se almacenan en la base de datos ASPState de SQL Server.

c: personalizado. Los datos del estado de sesión y los procedimientos almacenados se almacenan en una base de datos personalizada. El nombre de la base de datos debe especificarse mediante la opción -d.

Comentarios

Se pueden establecer varios tipos de opciones con la herramienta Registro de SQL Server para ASP.NET. Se puede especificar una conexión SQL, especificar qué servicios de aplicaciones ASP.NET utilizan SQL Server para administrar la información, indicar qué base de datos o tabla se utiliza para la dependencia de caché de SQL, así como agregar o quitar compatibilidad con el uso de SQL Server para almacenar los procedimientos y estados de sesión.

Varios servicios de aplicaciones ASP.NET dependen de un proveedor para administrar el almacenamiento y la recuperación de datos desde un origen de datos. Cada proveedor es específico del origen de datos. ASP.NET incluye un proveedor de SQL Server para las siguientes características de ASP.NET:

Al instalar ASP.NET, el archivo Machine.config del servidor incluye elementos de configuración que especifican los proveedores de SQL Server para cada una de las características de ASP.NET que dependen de un proveedor. Estos proveedores están configurados de manera predeterminada para la conexión a una instancia de usuario local de SQL Server Express 2005. Si cambia la cadena de conexión predeterminada utilizada por los proveedores, para poder utilizar las características de ASP.NET definidas en la configuración del equipo, deberá instalar la base de datos de SQL Server y los elementos de base de datos para la característica elegida mediante Aspnet_regsql.exe. Si la base de datos especificada con la herramienta de registro de SQL no existe (aspnetdb será la base de datos predeterminada si no se ha especificado ninguna en la línea de comandos), el usuario actual deberá tener derechos para crear bases de datos en SQL Server y crear elementos de esquema en una base de datos.

Cada proveedor de SQL Server puede utilizar la misma base de datos de SQL Server para almacenar los datos correspondientes a esa característica particular. Cada característica puede utilizarse individualmente o junto con otras características. Por ejemplo, la administración de funciones puede utilizarse sola o junto con la información de usuario administrada por la característica de suscripción.

Para obtener más información sobre los proveedores de SQL Server y ASP.NET, vea Implementar un proveedor de suscripciones, Implementar un proveedor de perfiles e Implementar un proveedor de funciones.

Dependencia de caché de SQL

Una característica avanzada del almacenamiento en la caché de resultados de ASP.NET es la dependencia de caché de SQL. La dependencia de caché de SQL admite dos modos de funcionamiento: uno que utiliza una implementación de ASP.NET del sondeo de tablas y un segundo modo que utiliza las características de notificación de consulta de SQL Server 2005. La herramienta de registro de SQL puede utilizarse para configurar el modo de funcionamiento de sondeo de tablas. La dependencia de caché de SQL permite almacenar en la caché páginas que dependen de datos de las tablas de SQL Server. SQL Server y ASP.NET pueden configurarse para que almacenen las solicitudes de páginas en la memoria caché, reduciendo la carga de trabajo del servidor, hasta que los datos de los que depende la página se hayan actualizado en SQL Server. La dependencia de caché de SQL es práctica para datos como catálogos de productos o información de registro de clientes que es relativamente estática. Observe que es preciso configurar SQL Server para que notifique correctamente a ASP.NET de los cambios que se producen en los datos dependientes cuando utiliza el modo de sondeo de tablas de ASP.NET de la dependencia de caché de SQL, por lo que necesitará privilegios administrativos para configurar el servidor. Para obtener más información sobre la dependencia de caché de SQL, vea Tutorial: Utilizar el almacenamiento en la caché de resultados de ASP.NET con SQL Server o Walkthrough: Using Output Caching to Enhance Web Site Performance.

Estado de sesión

El estado de sesión de ASP.NET se ha diseñado para que pueda almacenar con facilidad los datos de sesión del usuario en diferentes orígenes de las aplicaciones ASP.NET. De forma predeterminada, los valores y la información del estado de sesión se almacenan en memoria en el proceso de ASP.NET. Otra alternativa es almacenar los datos de sesión en una base de datos de SQL Server, donde varios servidores Web pueden compartir esta información. Para obtener más información sobre los estados de sesión, vea Implementar un proveedor de almacén de estados de sesión y Modos de estado de sesión.

Si la base de datos que especifique para el estado de sesión con la herramienta de registro de SQL no existe, el usuario actual deberá tener derechos para crear bases de datos en SQL Server y crear elementos de esquema en una base de datos. Si la base de datos existe, el usuario actual deberá tener derechos para crear elementos de esquema en la base de datos existente.

Para instalar la base de datos de estados de sesión en SQL Server, ejecute la herramienta Aspnet_regsql.exe y proporcione la información siguiente con el comando:

  • El nombre de la instancia de SQL Server, mediante la opción -S.

  • Las credenciales de inicio de sesión para una cuenta con permiso para crear una base de datos en un equipo que ejecute SQL Server. Utilice la opción -E para usar el usuario que ha iniciado la sesión actual o utilice la opción -U para especificar un identificador de usuario junto con la opción -P para especificar una contraseña.

  • La opción de la línea de comandos -ssadd para agregar la base de datos de estados de sesión.

De forma predeterminada, no se puede utilizar la herramienta Aspnet_regsql.exe para instalar la base de datos de estados de sesión en un equipo que ejecute SQL Server 2005 Express. Para obtener más información sobre cómo utilizar SQL Server 2005 Express para almacenar el estado de sesión, vea Modos de estado de sesión.

Ejemplos

Si se ejecuta sin argumentos de línea de comandos, Aspnet_regsql.exe ejecuta un asistente que le guiará en el proceso de especificar la información de conexión de la base de datos de SQL Server, así como en el proceso de instalar o quitar elementos de base de datos de las características compatibles. Aspnet_regsql.exe también puede ejecutarse como una herramienta de línea de comandos para especificar los elementos de base de datos de determinadas características que se van a agregar o quitar. Para especificar la configuración de la dependencia de caché de SQL o definir el estado de sesión, debe utilizar la herramienta de la línea de comandos.

Para ejecutar el asistente, ejecute Aspnet_regsql.exe sin argumentos de línea de comandos, tal como se muestra en el ejemplo siguiente:

C:\WINDOWS\Microsoft.NET\Framework\<versionNumber>\aspnet_regsql.exe

La herramienta Registro de SQL Server para ASP.NET suele utilizarse con la opción -A o -R para especificar las características que utilizan un proveedor de SQL Server. La opción -A permite agregar compatibilidad con una o varias características, mientras que la opción -R permite quitar una característica. El siguiente comando instala los elementos de base de datos para las características de Suscripción y Administrador de funciones en el equipo local donde se ejecuta SQL Server mediante la autenticación de Windows.

aspnet_regsql.exe -E -S localhost -A mr

Para configurar la dependencia de caché de SQL, se necesitan privilegios administrativos o se requieren la cuenta administrativa y la contraseña. El siguiente comando habilita la dependencia de caché de SQL para la tabla Empleados en la base de datos Northwind.

aspnet_regsql.exe -S <Server> -U <Username> -P <Password> -ed -d Northwind -et -t Employees

El siguiente comando crea una base de datos denominada ASPState en una instancia de SQL Server denominada "SampleSqlServer" y especifica que los datos de sesión también se almacenan en la base de datos ASPState.

aspnet_regsql.exe -S SampleSqlServer -E -ssadd -sstype p

Vea también

Mostrar: