Compartilhar via


Ferramenta de inscrição do SQL servidor do ASP.NET (aspnet_regsql.exe)

A ferramenta de inscrição do SQL servidor ASP.NET (aspnet_regsql.exe) é usada para criar um banco de dados do Microsoft SQL servidor que é usado pelos provedores do SQL servidor no ASP.NET. A ferramenta também é usada para adicionar ou remover opções de um banco de dados existente.

Independentemente da qual versão do .NET estrutura que você está trabalhando, o arquivo aspnet_regsql.exe está localizado na seguinte pasta no computador do servidor Web:

[drive:]\%windir%\Microsoft.NET\Framework\v2.0.50727

Você pode executar o aspnet_regsql.exe sem quaisquer argumentos de linha de comando para executar um assistente que vai orientá-lo por meio de especificar informações de conexão para sua instalação do SQL servidor e instalando ou removendo elementos da associação, gerenciamento de funções, analisar, personalização de Web Parts e recursos de monitoramento de integridade do banco de dados. (Estado de sessão de configuração e dependência de cache do SQL não são cobertos pelo assistente.) Você também pode executar aspnet_regsql.exe sistema autônomo uma ferramenta de linha de comando para especificar elementos de banco de dados para recursos individuais adicionar ou remover, usando sistema autônomo opções listadas na tabela a seguir.

Aspnet_regsql.exe <options>

Opções de conexão do SQL

Opção

Descrição

-?

Imprime texto aspnet_regsql.exe ajuda na janela Comando.

-W

Executa a ferramenta no modo de assistente. Isso é o padrão se nenhum argumento de linha de comando for especificado.

-C <connection string>

Especifica a cadeia de conexão ao computador que está executando o SQL servidor onde o banco de dados será instalado ou já está instalado. Esta opção não é necessária se você especificar somente o servidor (-S) e login (-U e -P, ou -E) informações.

-S <server>

Especifica o nome do computador que executa o SQL servidor onde o banco de dados será instalado ou já está instalado.

-U <login ID>

A ID de usuário do SQL servidor para fazer logon com. Esta opção também requer a opção de senha (-P). Esta opção não é necessária se você estiver autenticando usando credenciais do Windows (-E).

-P <password>

A senha do SQL Server para fazer login. Essa opção também requer a ID do usuário (-U) opção. Esta opção não é necessária se você estiver autenticando usando credenciais do Windows (-E).

-E

Autentica usando as credenciais do Windows do usuário conectado no momento.

-sqlexportonly <filename>

Gera um arquivo de script SQL que pode ser usado para adicionar ou remover os recursos especificados. As ações especificadas não são executadas.

Serviços aplicativo opções

Opção

Descrição

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

Adiciona suporte para o ASP.NET de um ou mais aplicativo serviços. Identificadores de serviço podem ser especificados juntos ou separadamente. Identificadores a seguir são usados para ASP.NET aplicativo serviços:

all -Todos os serviços, incluindo tabelas comuns e procedimentos armazenados compartilhados pelos serviços

m -Associação

r -Função Manager

p -analisar

c -Web Parts personalização

w -Eventos web

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

Remove o suporte para um ou mais serviços de aplicativo. Identificadores de serviço podem ser especificados juntos ou separadamente. Identificadores a seguir são usados para ASP.NET aplicativo serviços:

all -Todos os serviços, incluindo tabelas comuns e procedimentos armazenados compartilhados pelos serviços

m -Associação

r -Função Manager

p -analisar

c -Web Parts personalização

w -Eventos web

-Q

Executa a ferramenta no modo silencioso e não confirmar antes de remover um serviço de aplicativo.

-d <database>

Especifica o nome do banco de dados para criar ou modificar para uso com aplicativo serviços. Se o banco de dados não for especificado, o nome de banco de dados padrão "aspnetdb" é usado.

ObservaçãoObservação:

Os elementos de banco de dados que são instalados no banco de dados de serviços de aplicativo sempre irão ser pertencente a conta de proprietário do banco de dados do SQL servidor (dbo). Você não precisa ser um administrador do sistema para o computador que está executando o SQL servidor para instalar o banco de dados de serviços de aplicativo. Para instalar o banco de dados de serviços de aplicativo, um logon do SQL servidor deve ter permissão para o db_ddladmin e dd_securityadmin funções para o banco de dados do SQL servidor.

SQL Cache dependência opções (para Microsoft SQL servidor 7.0, Microsoft SQL servidor 2000 e SQL servidor 2005)

Opção

Descrição

-d <database>

Especifica o nome do banco de dados para usar com dependência de cache do SQL. O banco de dados, opcionalmente, pode ser especificado usando a opção de seqüência de caracteres de conexão, -C.

-ed

Permite que um banco de dados para dependência de cache do SQL.

-dd

Desativa um banco de dados para dependência de cache do SQL.

-et

Permite que uma tabela para dependência de cache do SQL. The -t opção também deve ser incluída na cadeia de caracteres de parâmetro.

-dt

Desativa a uma tabela para dependência de cache do SQL. The -t opção também deve ser incluída na cadeia de caracteres de parâmetro.

-t <table>

Especifica o nome da tabela para ativar ou desabilitar para uso com dependência de cache do SQL. Esta opção deve ser usada com o -et ou -dt opções.

-lt

Lista todas as tabelas habilitadas para dependência de cache do SQL.

Opções de estado de sessão

Opção

Descrição

-d <database>

Especifica o nome do banco de dados para armazenar estado de sessão. Esta opção deve ser usada se -sstype é definido como c.

-ssadd

Adiciona suporte para o estado de sessão do modo SQL servidor.

-ssremove

Remove o suporte para o estado de sessão do modo SQL servidor.

-sstype t|p|c

Especifica o tipo de estado de sessão para usar:

t -Temporário. Dados do estado de sessão é armazenados no banco de dados de tempdb do SQL servidor. Procedimentos armazenados para gerenciar o estado de sessão são instalados no banco de dados ASPState do SQL servidor. Dados não terão efeitos se você reiniciar o SQL. Este é o padrão.

p -Persistentes. Dados do estado de sessão e procedimentos armazenados são armazenados no banco de dados ASPState do SQL servidor.

c -Custom. Dados do estado de sessão e procedimentos armazenados são armazenados em um banco de dados personalizado. O nome do banco de dados deve ser especificado usando o -d opção.

Comentários

Você pode conjunto vários tipos de opções com a ferramenta de inscrição do ASP.NET no SQL servidor. Você pode especificar uma conexão SQL, especifique quais serviços de aplicativo ASP.NET usam SQL servidor para gerenciar informações, indique qual banco de dados ou tabela é usada para dependência de cache do SQL e adicionar ou remover o suporte ao uso do SQL servidor para armazenar estado de sessão e procedimentos.

Vários serviços de aplicativos ASP.NET contam com um provedor de gerenciar, armazenar e recuperar dados de uma fonte de dados. Cada provedor é específico para a fonte de dados. ASP.NET inclui um provedor do SQL servidor para os seguintes recursos do ASP.NET:

Quando você instala o ASP.NET, o arquivo computador.config para o servidor inclui elementos de configuração que especificar provedores SQL Server para cada um dos recursos ASP.NET que dependem de um provedor. Esses provedores são configurados, por padrão, para se conectar a uma instância de usuário local do SQL servidor 2005 Express. Se você alterar a cadeia de conexão padrão usada pelos provedores, em seguida, antes de usar qualquer um dos recursos do ASP.NET definidos em configuração da computador, você deve instalar o banco de dados do SQL servidor e os elementos do banco de dados para o recurso escolhido usando aspnet_regsql.exe. Se o banco de dados que você especificar com aspnet_regsql.exe ainda não existe (aspnetdb será o banco de dados padrão se não for especificado na linha de comando), e, em seguida, o usuário corrente deve ter direitos para criar bancos de dados no SQL servidor, bem sistema autônomo para criar elementos de esquema em um banco de dados.

Cada provedor do SQL servidor pode usar o mesmo banco de dados do SQL servidor para armazenar os dados para o recurso específico. Cada recurso pode ser usado individualmente, ou em conjunto com outros recursos. Por exemplo, você poderia utilizar gerenciamento de função sozinha ou em conjunto com as informações do usuário gerenciadas pela associação.

Para obter mais informações sobre provedores de SQL servidor e do ASP.NET, consulte Implementando um Provedor de Associação, Implementando um provedor perfil, e Implementar um provedor de função.

SQL Cache dependência

Um recurso avançado de cache de saída do ASP.NET é a dependência de cache do SQL. Dependência de cache SQL oferece suporte a dois modos diferentes de operação: uma que usa uma implementação do ASP.NET do sondagem de tabela e um segundo modo que usa os recursos de notificação de consulta do SQL servidor 2005. Aspnet_regsql.exe pode ser usado para configurar o modo de tabela de sondagem de operação. A dependência de cache do SQL permite que você armazene em cache páginas que são dependentes de dados de tabelas do SQL Server. Você pode configurar o SQL Server e o ASP.NET para armazenar solicitações de cache de página, reduzindo a carga de trabalho do servidor, até que os dados dos quais a página depende tiverem sido atualizados no SQL Server. A dependência de cache do SQL é útil para dados como catálogos de produtos ou informações de registro de clientes que permanecem comparativamente estáticos. Observe que você deve configurar o SQL servidor para fornecer notificação adequada para o ASP.NET sobre alterações nos dados dependentes quando você usa o modo de tabela de sondagem do ASP.NET de dependência de cache do SQL. Assim, você precisará de privilégios administrativos para configurar o servidor. Para obter mais informações sobre dependência de cache SQL, consulte Demonstra Passo a passo: Usando o cache com de saída do ASP.NET SQL Servidor.

Session State (Estado da sessão)

estado de sessão ASP.NET foi projetado para permitir que você com com facilidade armazenar dados de sessão do usuário em fontes diferentes para seus aplicativos ASP.NET. Por padrão, informações e valores do estado de sessão são armazenados na memória dentro do processo do ASP.NET. Como alternativa, você pode armazenar dados da sessão em um banco de dados do SQL servidor, onde pode ser compartilhado por vários servidores Web. Para obter mais informações sobre estado de sessão, consulte Implementar um Provedor de Armazenamento de Estado da Sessão e Modos de estado de sessão.

Se o banco de dados que você especificar para estado de sessão com aspnet_regsql.exe já não existir, o usuário corrente deve ter direitos para criar bancos de dados no SQL servidor, bem sistema autônomo para criar elementos de esquema em um banco de dados. Se o banco de dados existir, o usuário corrente deve ter direitos para criar elementos de esquema do banco de dados existente.

Para instalar o banco de dados do estado de sessão no SQL servidor, execute aspnet_regsql.exe ferramenta fonte as seguintes informações com o comando:

  • O nome da instância do SQL servidor, usando o -S opção.

  • As credenciais de logon para uma conta que tenha permissão para criar um banco de dados em um computador executando o SQL servidor. Use a opção -E para usar o usuário conectado no momento, ou utilize a opção -U para especificar uma identificação de usuário junto com a opção -P para especificar uma senha.

  • A opção -ssadd de linha de comando para adicionar o banco de dados do estado de sessão.

Por padrão, você não pode usar aspnet_regsql.exe para instalar o banco de dados do estado de sessão em um computador que esteja executando o SQL servidor 2005 Express edição. Para obter mais informações sobre como usar o SQL servidor 2005 Express edição para armazenar estado de sessão, consulte Modos de estado de sessão.

Exemplos

Você pode executar o aspnet_regsql.exe sem quaisquer argumentos de linha de comando para executar um assistente que vai orientá-lo por meio de especificar informações de conexão para o banco de dados do SQL servidor e instalando ou removendo elementos de recursos suportados do banco de dados. Você também pode executar Aspnet_regsql.exe como uma ferramenta de linha de comando para especificar elementos do banco de dados para recursos individuais para adicionar ou remover. Para especificar configurações de dependência de cache SQL ou conjunto o estado de sessão, você deve usar a ferramenta de linha de comando.

Para executar o assistente, execução sistema autônomopnet_regsql.exe sem quaisquer argumentos de linha de comando sistema autônomo mostrado no exemplo a seguir.

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

A ferramenta de inscrição de SQL do ASP.NET é normalmente usada com o -A ou -R opção para especificar quais recursos usam um provedor do SQL servidor. The -A opção permite adicionar suporte para um ou mais recursos, enquanto o -R opção permite que você remover um recurso. O comando a seguir instala os elementos de banco de dados de gerenciamento de associação e funções no computador local executando SQL servidor usando a autenticação do Windows.

aspnet_regsql.exe -E -S localhost -A mr

Para configurar a dependência de cache SQL, você precisa de privilégios administrativos ou a conta administrativa e a senha. O comando a seguir habilita a dependência de cache do SQL para a tabela Funcionários no banco de dados Northwind.

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

O comando a seguir cria um banco de dados denominado ASPState em uma instância do SQL servidor chamada "SampleSqlServer" e especifica que os dados da sessão também são armazenados no banco de dados ASPState.

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

Consulte também

Conceitos

Implementando um Provedor de Associação

Implementando um provedor perfil

Implementar um provedor de função