Split-SPScaleOutDatabase

  • Referência
Módulo:
SharePointServer
Aplica-se a:
SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Move uma porcentagem especificada de partições de um banco de dados de dimensionamento para outro.

Syntax

Split-SPScaleOutDatabase
     -NewDatabaseName <String>
     -SourceDatabase <SPDatabasePipeBind>
     -SourceServiceApplication <SPServiceApplicationPipeBind>
     [-AssignmentCollection <SPAssignmentCollection>]
     [-Confirm]
     [-MoveLowerHalf]
     [-NewDatabaseCredentials <PSCredential>]
     [-NewDatabaseFailoverServer <String>]
     [-NewDatabaseServer <String>]
     [-SourcePercentage <Int32>]
     [-WhatIf]
     [<CommonParameters>]
Split-SPScaleOutDatabase
     -SourceDatabase <SPDatabasePipeBind>
     -SourceServiceApplication <SPServiceApplicationPipeBind>
     -TargetDatabase <SPDatabasePipeBind>
     [-AssignmentCollection <SPAssignmentCollection>]
     [-Confirm]
     [-MoveLowerHalf]
     [-SourcePercentage <Int32>]
     [-WhatIf]
     [<CommonParameters>]

Description

Este cmdlet contém mais de um parâmetro definido. Você pode usar apenas parâmetros de um conjunto de parâmetro e você não pode combinar parâmetros de diferentes conjuntos de parâmetros. Para obter mais informações sobre como usar conjuntos de parâmetros, confira Conjuntos de parâmetros de Cmdlets.

Use o Split-SPScaleOutDatabase cmdlet para mover uma porcentagem especificada de partições de um banco de dados de origem para um banco de dados de destino existente ou para um novo banco de dados que você cria com os parâmetros especificados.

Para obter as permissões e informações mais recentes sobre o Windows PowerShell para Produtos SharePoint, confira a documentação online em Cmdlets do SharePoint Server.

Exemplos

---------------EXEMPLO 1---------------

$databases = Get-SPScaleOutDatabase -ServiceApplication $serviceApplication
$database = $databases[0]
Split-SPScaleOutDatabase -NewDatabaseName Database2 -NewDatabaseServer MyDatabaseServer -SourceDatabase $database -SourceServiceApplication $serviceApplication -SourcePercentage 30

Este exemplo cria um novo banco de dados de dimensionamento chamado Database2 no servidor do banco de dados MyDatabaseServer no determinado aplicativo de serviço.

O exemplo também move 30% dos dados do lado superior do intervalo de dados no primeiro banco de dados de expansão do aplicativo de serviço fornecido.

---------------EXEMPLO 2---------------

$ssa = Get-SPEnterpriseSearchServiceApplication

$newReportingDb = "Search_AnalyticsReporting2"
$reportingDb = Get-SPScaleOutDatabase -SearchApplication $ssa
Split-SPServerScaleOutDatabase -SourceServiceApplication $ssa -SourceDatabase $reportingDb -NewDatabaseName $newReportingDb -SourcePercentage 33

Este exemplo dimensiona o banco de dados do Search Analytics, movendo 33% dos dados para os novos bancos de dados.

Parâmetros

-AssignmentCollection

Gerencia objetos para o devido descarte. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos após o uso para liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não forem usados.

Quando o parâmetro Global é usado, todos os objetos estão contidos no repositório global. Quando os objetos não são usados imediatamente ou são descartados com o uso do comando Stop-SPAssignment, pode ocorrer um cenário de memória insuficiente.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Confirm

Solicita sua confirmação antes de executar o comando. Para saber mais, digite o seguinte comando: get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-MoveLowerHalf

Especifica se deve mover o lado superior ou inferior do intervalo de dados no banco de dados de dimensionamento de origem. Se este parâmetro não é especificado, o comportamento padrão é mover o lado superior do intervalo de dados do banco de dados de dimensionamento de origem.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-NewDatabaseCredentials

Especifica as credenciais a usar ao criar o banco de dados de dimensionamento. Estas credenciais precisarão ter direitos de proprietário nos bancos de dados de dimensionamento criados recentemente. Se um valor não for fornecido, as credenciais do usuário atual serão usadas por padrão.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-NewDatabaseFailoverServer

Especifica o nome do servidor de failover do novo banco de dados de dimensionamento a ser criado. Se um valor não é fornecido, o novo banco de dados de dimensionamento não possui um servidor de failover.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-NewDatabaseName

Especifica o nome de um novo banco de dados de dimensionamento que você está criando.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-NewDatabaseServer

Especifica o nome do servidor do novo banco de dados de dimensionamento a ser criado. Se um valor não é fornecido, o servidor do banco de dados padrão é usado.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SourceDatabase

O banco de dados de dimensionamento de origem para obter os dados.

Type:SPDatabasePipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SourcePercentage

Especifica a porcentagem de dados no banco de dados de dimensionamento de origem para mover. Se um valor não é fornecido, o valor padrão de 50 por cento é usado.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SourceServiceApplication

O aplicativo de serviço no qual a operação mover dados irá ocorrer.

Type:SPServiceApplicationPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-TargetDatabase

O banco de dados de dimensionamento de destino para enviar os dados.

Type:SPDatabasePipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WhatIf

Exibe uma mensagem que descreve o efeito do comando em vez de executar o comando. Para saber mais, digite o seguinte comando: get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019