Addcontentdb: operação de Stsadm (Windows SharePoint Services)
Atualizado em: 2008-07-15
Nome da operação: Addcontentdb
Descrição
Cria um novo banco de dados de conteúdo ou adiciona um banco de dados que precise ser atualizado quando os parâmetros url e databasename são especificados.
Quando é criado um banco de dados de conteúdo, a localização do arquivo de dados e de log é determinada pelas configurações do banco de dados padrão estabelecidas no servidor de banco de dados do SQL. É criado um banco de dados de conteúdo com um grupo de arquivos primários que hospedam um arquivo de dados (.mdf) e um arquivo de log de transação (.ldf). Quando a operação addcontentdb é usada para criar um banco de dados de conteúdo, é preciso executar a operação spsearch para associar um banco de dados de conteúdo a um servidor específico que esteja executando o serviço de pesquisa do Windows SharePoint Services. Para obter outras informações sobre a operação spsearch, consulte Spsearch: operação de Stsadm (Windows SharePoint Services).
Importante
Se você desanexar e anexar novamente um banco de dados de conteúdo, saiba que na próxima vez em que o conteúdo nesse banco de dados for rastreado, um rastreamento completo ocorrerá, mesmo que um rastreamento incremental tenha sido solicitado. Como o rastreamento completo rastreia novamente todo o conteúdo encontrado pelo rastreador, quer o conteúdo tenha sido rastreado antes ou não, esse tipo de rastreamento pode demorar muito mais do que os rastreamentos incrementais.
Sintaxe
stsadm.exe -o addcontentdb
** -url <Nome de URL>**
-[-assignnewdatabaseid]
-[-clearchangelog]
** -databasename <nome do banco de dados>**
[-databaseserver <nome do servidor do banco de dados>]
[-databaseuser <nome do usuário do banco de dados>]
[-databasepassword <senha do banco de dados>]
[-sitewarning <contagem de aviso de site>]
[-sitemax <contagem máx de site>]
Parâmetros
| Nome e forma abreviada do parâmetro | Valor | Obrigatório? | Descrição |
|---|---|---|---|
url |
Uma URL válida, como http://nome_do_servidor |
Sim |
URL do aplicativo Web ao qual o banco de dados de conteúdo está sendo adicionado. |
assignnewdatabaseid |
Um GUID válido, como "12345678-90ab-cdef-1234-567890bcdefgh" |
Não |
Cria uma nova identificação de banco de dados automaticamente quando um banco de dados de conteúdo é anexado. Esse parâmetro foi apresentado pela primeira vez no Atualização de infraestrutura para o Windows SharePoint Services 3.0. Para obter mais informações, consulte Comentários. |
clearchangelog |
<nenhum> |
Não |
Limpa o log de alterações Faz com que o log de alterações seja limpo quando necessário, por exemplo, quando o banco de dados de conteúdo for restaurado para um ponto anterior utilizando-se ferramentas de backup SQL de Nível de servidor separadas. Esse parâmetro foi apresentado pela primeira vez no Atualização de infraestrutura para o Windows SharePoint Services 3.0. Para obter mais informações, consulte Comentários. |
databasename (dn) |
Um nome de banco de dados válido, como "DB1" |
Sim |
Nome do banco de dados. |
databaseserver (ds) |
Um nome de servidor de banco de dados válido, como "Sales", em que instâncias nomeadas são usadas; o formato pode ser exibido como servidor\servidor |
Não |
Nome do servidor do banco de dados. O servidor padrão é usado se um valor não for fornecido. |
databaseuser |
Um nome de usuário válido no formato "Username1" |
Não |
Conta usada para autenticação SQL. Deve ser usada em conjunto com o parâmetro databasepassword. |
databasepassword |
Uma senha SQL válida |
Não |
O parâmetro databasepassword deverá ser usado onde a autenticação do Windows não estiver implementada. Logo, em um cenário de autenticação Microsoft SQL Server, você precisa transmitir os parâmetros databaseuser e databasepassword para a autenticação no servidor do banco de dados. Na autenticação do Windows, você pode omitir esses parâmetros, pois as credenciais são transmitidas por NTLM. |
sitewarning |
Um número inteiro válido, como 10 |
Não |
Número inteiro de conjuntos de sites permitidos no banco de dados de conteúdo antes da geração de um evento de aviso no log de eventos do Windows. |
sitemax |
Um número inteiro válido, como 10 |
Não |
Especifica o número máximo de conjuntos de sites permitidos no banco de dados de conteúdo. |
Comentários
Se estiver executando o Atualização de infraestrutura para o Windows SharePoint Services 3.0, o identificador (ID) de cada banco de dados de conteúdo será mantido quando você restaurar ou reanexar o banco de dados, usando as ferramentas internas. O comportamento padrão de retenção do log de alterações, quando ferramentas internas são utilizadas, é o seguinte:
Os logs de alterações de todos os bancos de dados são mantidos quando você restaura um farm.
O log de alterações de um banco de dados de conteúdo é mantido quando você reanexa o banco de dados.
O log de alterações de um banco de dados de conteúdo NÃO é mantido quando você restaura o banco de dados de conteúdo.
Para obter mais informações, consulte Mover bancos de dados de conteúdo (Windows SharePoint Services 3.0) e Back up and restore the entire farm (Windows SharePoint Services 3.0 technology).
Se você restaurar um backup de um banco de dados de conteúdo de um SQL Server anterior, o índice de Pesquisa pode conter mais entradas do que os bancos de dados restaurados no farm. Primeiro, use o comando Stsadm stsadm –o deletecontentdb para desanexar o banco de dados do farm do SharePoint e restaure o banco de dados usando ferramentas do SQL Server. A seguir, use o comando Stsadm stsadm –o addcontentdb –clearchangelog para reanexar o banco de dados de conteúdo e limpar o log de alterações. A limpeza do log de alterações faz com que a Pesquisa execute um rastreamento completo no banco de dados para que o índice deixe de fazer referência a itens que não existem mais.
Como administrador, você deve saber quando e se um log de alterações deve ser limpo. Por exemplo, se um banco de dados de conteúdo for restaurado para um momento anterior ao último rastreamento por meio de ferramentas de backup no nível do Microsoft SQL Server, e essa operação for usada para reanexá-lo ao farm, não limpar o log de alterações pode fazer com que o índice exiba entradas para itens nesse banco de dados de conteúdo que não existem no banco de dados restaurado. Para evitar que isso ocorra nesse cenário, use o parâmetro clearchangelog para limpar o log. Se um banco de dados de conteúdo foi anexado por engano sem o parâmetro clearchangelog, você deve desanexar e anexar novamente o banco de dados de conteúdo usando o parâmetro clearchangelog para que o próximo rastreamento possa restaurar o índice desse banco de dados de conteúdo.
Quando um banco de dados de conteúdo é anexado ao mesmo aplicativo Web, o log de alterações será, por padrão, preservado junto com a identificação do banco de dados. Se for necessário mudar a identidade do banco de dados, por exemplo, se houver um conflito de identidades, o parâmetro assignnewdatabaseid fará com que uma nova identidade seja selecionada para o banco de dados de conteúdo.
Você receberá a seguinte mensagem de erro caso não não seja possível anexar o banco de dados ao farm devido a um conflito: A operação de anexação não pode continuar porque outro objeto neste farm já contém a mesma identidade. Cada objeto em um farm deve ter uma identidade exclusiva. Para realizar a operação de anexação, você deve atribuir uma nova identidade para esse banco de dados. Para anexar esse banco de dados com uma nova identidade, use a operação "stsadm.exe -o addcontentdb" com o parâmetro -assignnewdatabaseid. Observe que, se esse novo banco de dados e um banco de dados existente possuírem os mesmos conjuntos de sites, anexar esse banco de dados provavelmente resultará em conjuntos de sites órfãos graças a conflitos entre os dois bancos de dados.