Invoke-ASCmd

Модуль:

SQLServer

Позволяет администраторам баз данных выполнять скрипт XMLA, скрипт TMSL, запрос выражений анализа данных (DAX), запрос многомерных выражений или инструкцию расширений интеллектуального анализа данных (DMX) для экземпляра служб Analysis Services.

Синтаксис

Invoke-ASCmd
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-ASCmd
      [-Database <String>]
      [-Query <String>]
      [-ConnectionString <String>]
      [-QueryTimeout <Int32>]
      [-ConnectionTimeout <Int32>]
      [-TraceFile <String>]
      [-Variables <String[]>]
      [-TraceTimeout <Int32>]
      [-TraceLevel <TraceLevelOption>]
      [-TraceFileFormat <TraceFileFormatOption>]
      [-TraceFileDelimiter <String>]
      [-Server <String>]
      [-Credential <PSCredential>]
      [-ServicePrincipal]
      [-ApplicationId <String>]
      [-TenantId <String>]
      [-CertificateThumbprint <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-ASCmd
      [-Database <String>]
      [-ConnectionString <String>]
      [-InputFile <String>]
      [-QueryTimeout <Int32>]
      [-ConnectionTimeout <Int32>]
      [-TraceFile <String>]
      [-Variables <String[]>]
      [-TraceTimeout <Int32>]
      [-TraceLevel <TraceLevelOption>]
      [-TraceFileFormat <TraceFileFormatOption>]
      [-TraceFileDelimiter <String>]
      [-Server <String>]
      [-Credential <PSCredential>]
      [-ServicePrincipal]
      [-ApplicationId <String>]
      [-TenantId <String>]
      [-CertificateThumbprint <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-ASCmd
      [-Server <String>]
      [-Credential <PSCredential>]
      [-ServicePrincipal]
      [-ApplicationId <String>]
      [-TenantId <String>]
      [-CertificateThumbprint <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-ASCmd
      [-Server <String>]
      [-Credential <PSCredential>]
      [-ServicePrincipal]
      [-ApplicationId <String>]
      [-TenantId <String>]
      [-CertificateThumbprint <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

Позволяет администраторам баз данных выполнять скрипт XMLA, скрипт TMSL, запрос выражений анализа данных (DAX), запрос многомерных выражений или инструкцию расширений интеллектуального анализа данных (DMX) для экземпляра служб Analysis Services.

Командлеты, выполняемые этими запросами или скриптами во входных файлах.

Передаваемый скрипт является командой XMLA, и поддерживаются следующие команды: Alter, Backup, Batch, BeginTransaction, Cancel, ClearCache, CommitTransaction, Create, Delete, DesignAggregations, Drop, Insert, Lock, MergePartitions, NotifyTableChange, Process, Restore, RollbackTransaction, Statement (используется для выполнения запросов многомерных выражений и dmX-инструкций), Subscribe, Synchronize, Unlock, Update, UpdateCells.

Этот скрипт также принимает команды JSON, предназначенные для выполнения в табличной базе данных с режимом совместимости 1200 или выше.

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

Примеры

Вызов обнаружения

Invoke-ASCmd -Server:localhost -Query "<Discover xmlns='urn:schemas-microsoft-com:xml-analysis'><RequestType>DBSCHEMA_CATALOGS</RequestType><Restrictions /><Properties /></Discover>"

Вызов обнаружения 2

Invoke-ASCmd -Database "Adventure Works DW 2008R2" -Query "<Discover xmlns='urn:schemas-microsoft-com:xml-analysis'><RequestType>DISCOVER_DATASOURCES</RequestType><Restrictions></Restrictions><Properties></Properties></Discover>"

Выбор вызова

Invoke-ASCmd -Database "Adventure Works DW 2008R2" -Query "SELECT {[Measures].[Internet Sales Amount]} ON COLUMNS, BOTTOMCOUNT(NONEMPTY(DESCENDANTS( [Customer].[Customer Geography].[All Customers], [Customer].[Customer Geography].[Customer]), ( [Measures].[Internet Sales Amount] ) ), 10, ( [Measures].[Internet Sales Amount] )) ON ROWS FROM [Adventure Works] WHERE ( [Date].[Calendar].[Calendar Year].&[2008] )"

Вызов выберите 2

Invoke-ASCmd -Database "Adventure Works DW 2008R2" -Query "SELECT MODEL_CATALOG, MODEL_NAME, ATTRIBUTE_NAME, NODE_NAME FROM [Forecasting].CONTENT"

Вызов с помощью xmla-файла

Invoke-ASCmd -InputFile C:\MyFolder\DiscoverConnections.xmla

<# DiscoverConnections.xmla is as follows:

 <Discover xmlns="urn:schemas-microsoft-com:xml-analysis">
   <RequestType>DISCOVER_CONNECTIONS</RequestType>
   <Restrictions />
   <Properties>
     <PropertyList>
       <Content>Data</Content>
     </PropertyList>
   </Properties>
 </Discover>

#>

Параметры

-ApplicationId

Идентификатор приложения для субъекта-службы.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificateThumbprint

Отпечаток сертификата для субъекта-службы.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Запрос подтверждения перед выполнением командлета.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConnectionString

Указывает строку подключения.

Обратите внимание, что другие свойства уровня подключения, такие как Сервер, База данных и т. д. игнорируются при указании этого свойства, поэтому эти свойства должны быть включены в строку подключения.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConnectionTimeout

Указывает количество секунд до истечения времени ожидания подключения к экземпляру служб Analysis Services. Значение времени ожидания должно быть целым числом от 0 до 65534. Если указано значение 0, попытки соединения не прекращаются.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Если этот параметр задан, указанные имя пользователя и пароль будут использоваться для подключения к заданному экземпляру сервера анализа данных. Если учетные данные не указаны, для пользователя, запустившего это средство, будет использоваться учетная запись Windows по умолчанию.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Database

Определяет базу данных, в которой выполняются запросы MDX или инструкции DMX. Параметр базы данных не учитывается, если командлет выполняет скрипт XML для аналитики, так как скрипт XML для аналитики содержит внедренное имя базы данных.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputFile

Идентифицирует файл, содержащий сценарий XMLA, запрос многомерных выражений, инструкцию расширения интеллектуального анализа данных или сценарий TMSL (в формате JSON). При использовании Invoke-AsCmd необходимо указать значение inputFile или *Query *.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Query

Указывает, что фактический скрипт, запрос или инструкция задается непосредственно в командной строке, а не в файле.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-QueryTimeout

Указывает количество секунд до истечения времени ожидания запросов. Если значение времени ожидания не указано, время ожидания запросов не истекает. Время ожидания должно быть целым числом от 1 до 65535.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Server

При необходимости указывает экземпляр сервера для подключения, если он отсутствует в каталоге поставщика SQLAS.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServicePrincipal

Указывает, что это подключение использует субъект-службу.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TenantId

Идентификатор клиента для субъекта-службы.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TraceFile

Определяет файл, в который поступают события трассировки служб Analysis Services при выполнении скрипта XML для аналитики, запроса многомерных выражений или инструкции расширений интеллектуального анализа данных. Если файл уже существует, он автоматически перезаписывается (за исключением файлов трассировки, созданных с помощью параметров -TraceLevel:Duration и -TraceLevel:DurationResult).

Имена файлов, содержащие пробелы, должны быть заключены в кавычки ("").

Если указано недопустимое имя файла, выдается сообщение об ошибке.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TraceFileDelimiter

Указывает один символ в качестве разделителя файла трассировки при указании CSV в качестве формата для файла трассировки, в котором используется параметр -TraceFileFormat.

Разделителем по умолчанию является символ | (вертикальная черта).

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TraceFileFormat

Задает формат файла для параметра -TraceFile (если этот параметр указан).

Значение по умолчанию — CSV.

Type:	TraceFileFormatOption
Accepted values:	Csv, Text
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TraceLevel

Задает тип данных, которые собираются и записываются в файл трассировки. Возможны следующие значения: High, Medium, Low, Duration, DurationResult.

Type:	TraceLevelOption
Accepted values:	High, Medium, Low, Duration, DurationResult
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TraceTimeout

Указывает время в секундах, в течение которых обработчик Analysis Services ожидает завершения трассировки (если указан параметр -TraceFile).

Предполагается, что трассировка заканчивается, если в течение заданного периода времени не записываются никакие сообщения трассировки.

По умолчанию период равен 5 секундам.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Variables

Задаются дополнительные переменные скрипта. Каждая переменная является парой «имя-значение». Если в значении содержатся пробелы или управляющие символы, оно должно заключаться в двойные кавычки. Для указания нескольких переменных и их значений используйте массив PowerShell.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Входные данные

PSObject

Выходные данные

string

Примечания

Поддерживается на всех экземплярах служб Analysis Services, включая PowerBI Premium