Invoke-ProcessPartition

モジュール:

SQLServer

特定のキューブ名と特定の ProcessType 値を持つ MeasureGroup 名を持つ特定のデータベースの特定のパーティションに対してプロセス操作を実行します。

構文

Invoke-ProcessPartition
      [-CubeName] <String>
      [-MeasureGroupName] <String>
      [-Name] <String>
      [-Database] <String>
      [-ProcessType] <ProcessType>
      [-Server <String>]
      [-Credential <PSCredential>]
      [-ServicePrincipal]
      [-ApplicationId <String>]
      [-TenantId <String>]
      [-CertificateThumbprint <String>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-ProcessPartition
      [-PartitionName] <String>
      [-TableName] <String>
      [-Database] <String>
      [-RefreshType] <RefreshType>
      [-Server <String>]
      [-Credential <PSCredential>]
      [-ServicePrincipal]
      [-ApplicationId <String>]
      [-TenantId <String>]
      [-CertificateThumbprint <String>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-ProcessPartition
      -DatabasePartition <Object>
      [-ProcessType] <ProcessType>
      [-Server <String>]
      [-Credential <PSCredential>]
      [-ServicePrincipal]
      [-ApplicationId <String>]
      [-TenantId <String>]
      [-CertificateThumbprint <String>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-ProcessPartition
      -DatabasePartition <Object>
      [-RefreshType] <RefreshType>
      [-Server <String>]
      [-Credential <PSCredential>]
      [-ServicePrincipal]
      [-ApplicationId <String>]
      [-TenantId <String>]
      [-CertificateThumbprint <String>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

特定のキューブ名と特定の ProcessType 値を持つ MeasureGroup 名を持つ特定のデータベースの特定のパーティションに対してプロセス操作を実行します。

Module requirements: version 21+ on PowerShell 5.1; version 21 (recent preview) or version 22+ on PowerShell 7.x.

例

パイプラインからパーティションを処理する

PS SQLSERVER:\SQLAS\MachineName\Instance\Databases\DB1\Cubes\myCube\MeasureGroups\myMeasureGroup\Partitions\Partition1> Get-Item . | Invoke-ProcessPartition -ProcessType ProcessDefault

このコマンドは、処理するパーティションの ID でパイプ処理します。

名前を使用してパーティションを処理する

PS SQL SERVER:\SQLAS\MachineName\Instance\Databases\AWTEST\Cubes\Adventure Works\MeasureGroups> Invoke-ProcessPartition �Name "Total_Orders_2003" �MeasureGroupname "Sales Order" �CubeName "Adventure Works" �database "AWTEST" �ProcessType "ProcessFull"

このコマンドは、'AWTEST' データベースの 'Sales Orders' メジャー グループ内のパーティション 'Total_Orders_2003' を処理します。

表形式メタデータ パーティションの処理

PS SQLSERVER:\SQLAS\MachineName\Instance\Databases\DB1> Invoke-ProcessPartition -PartitionName "myPartition" -TableName "myTable" -Database "DB1"  -RefreshType "Full"

列挙型の更新の種類を使用して表形式メタデータ パーティションを処理する

PS SQLSERVER:\SQLAS\MachineName\Instance\Databases\DB1> Invoke-ProcessPartition -PartitionName "myPartition" -TableName "myTable" -Database "DB1"  -RefreshType [Microsoft.AnalysisServices.Tabular.RefreshType]::Full

パラメーター

-ApplicationId

サービス プリンシパルのアプリケーション ID。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CertificateThumbprint

サービス プリンシパルの証明書の拇印。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Credential

このパラメーターを指定すると、渡されたユーザー名とパスワードが、指定した Analysis Server インスタンスへの接続に使用されます。

資格情報が指定されていない場合は、ツールを実行しているユーザーの既定の Windows アカウントが使用されます。

型:	PSCredential
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CubeName

MeasureGroup が属するキューブ名。 (多次元メタデータのみ)

型:	String
配置:	3
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Database

キューブが属するデータベース名。 (多次元および表形式のメタデータ)

型:	String
配置:	1
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DatabasePartition

処理する必要がある Microsoft.AnalysisServices.Partition オブジェクトまたは Microsoft.AnalysisService.Tabular.Partition オブジェクト。 (多次元メタデータと表形式メタデータそれぞれ)

型:	Object
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-MeasureGroupName

パーティションが属する MeasureGroup 名。(多次元メタデータのみ)

型:	String
配置:	4
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Name

処理する必要があるパーティションの名前。 (多次元メタデータのみ)

型:	String
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PartitionName

パーティションの名前。

型:	String
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ProcessType

プロセスの種類を指定します (多次元メタデータのみ)

型:	ProcessType
指定可能な値:	ProcessFull, ProcessAdd, ProcessUpdate, ProcessIndexes, ProcessData, ProcessDefault, ProcessClear, ProcessStructure, ProcessClearStructureOnly, ProcessScriptCache, ProcessRecalc, ProcessDefrag
配置:	2
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ProgressAction

スクリプト、コマンドレット、またはプロバイダーによって生成された進行状況の更新 (Write-Progress コマンドレットによって生成された進行状況バーなど) に対する PowerShell の応答方法を決定します。 Write-Progress コマンドレットは、コマンドの状態を示す進行状況バーを作成します。

型:	ActionPreference
Aliases:	proga
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RefreshType

更新の種類。

型:	RefreshType
指定可能な値:	Full, ClearValues, Calculate, DataOnly, Automatic, Add, Defragment
配置:	2
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Server

必要に応じて、SQLAS プロバイダー ディレクトリにない場合に接続するサーバー インスタンスを指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ServicePrincipal

この接続がサービス プリンシパルを使用していることを指定します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-TableName

テーブルの名前を指定します。

型:	String
配置:	1
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-TenantId

サービス プリンシパルのテナント ID。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

メモ

すべての Analysis Services インスタンスでサポートされます