Read-SqlViewData

模組:: SqlServer Module

從 SQL 資料庫的檢視讀取數據。

語法

ByPath (預設值)

Read-SqlViewData
    [[-Path] <String[]>]
    [-TopN <Int64>]
    [-ColumnName <String[]>]
    [-ColumnOrder <String[]>]
    [-ColumnOrderType <OrderType[]>]
    [-OutputAs <OutputTypeSingleTable>]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [<CommonParameters>]

ByName

Read-SqlViewData
    [[-ServerInstance] <String[]>]
    [-ViewName <String>]
    [-TopN <Int64>]
    [-ColumnName <String[]>]
    [-ColumnOrder <String[]>]
    [-ColumnOrderType <OrderType[]>]
    [-OutputAs <OutputTypeSingleTable>]
    [-DatabaseName <String>]
    [-SchemaName <String>]
    [-IgnoreProviderContext]
    [-SuppressProviderContextWarning]
    [-Credential <PSCredential>]
    [-ConnectionTimeout <Int32>]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [<CommonParameters>]

ByObject

Read-SqlViewData
    [-InputObject] <ScriptSchemaObjectBase[]>
    [-TopN <Int64>]
    [-ColumnName <String[]>]
    [-ColumnOrder <String[]>]
    [-ColumnOrderType <OrderType[]>]
    [-OutputAs <OutputTypeSingleTable>]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [<CommonParameters>]

Description

Read-SqlViewData Cmdlet 會讀取儲存在 SQL Database 檢視中的數據。您可以選取要讀取的數據行、限制資料列數目，以及排序和排序數據行。

您可以搭配 Windows PowerShell SQL 提供者使用此 Cmdlet。此 Cmdlet 可以從目前的路徑推斷伺服器、資料庫、架構和數據表等資訊。

此 Cmdlet 支援下列輸出格式：

數據。 System.Data.DataSet 類型的物件，其中包含一個數據表。
DataTable。 System.Data.DataTable 類型的物件。這個物件的 TableName 屬性與這個 Cmdlet 查詢的數據表相同。
DataRows。 System.Data.DateRow 物件的集合。

範例

範例 1：從檢視取得兩個數據列

PS C:\> Read-SqlViewData -ServerInstance "MyServer\MyInstance" -DatabaseName "MyDatabase" -SchemaName "dbo" -ViewName "MyView" -TopN 2

Id Name   Amount
-- ----   ------
10 AAAAA  -1.2
11 BBBBB  1.2

此命令會從實例上的MyDatabase.dbo.MyView資料庫檢視MyServer\MyInstance取得前兩個數據列。 TopN 參數會指定數據列數目（在此案例中為 2 個）。

範例 2：顯示整個檢視

PS C:\> cd SQLSERVER:\sql\MyServer\MyInstance\Databases\MyDatabase\Views\dbo.MyView
PS SQLSERVER:\sql\MyServer\MyInstance\Databases\MyDatabase\Views\dbo.MyView> Read-SqlViewData

Id Name Amount
-- ---- ------
10 AAAA -1.2
11 BBBB 1.2
12 CCCC -1.0
13 DDDD -2.0

第一個命令會將位置變更為 SQLSERVER 提供者中的檢視。命令提示字元會反映新位置。

範例 3：顯示選取的已排序數據行

PS C:\> cd SQLSERVER:\sql\MyServer\MyInstance\Databases\MyDatabase\Views\dbo.MyView
PS SQLSERVER:\sql\MyServer\MyInstance\Databases\MyDatabase\Views\dbo.MyView> Read-SqlViewData -TopN 3 -ColumnName "Id","Name" -ColumnOrder "Id","Name" -ColumnOrderType DESC,ASC

Id Name
-- ----
12 CCCC
11 BBBB
10 AAAA

參數

-AccessToken

用來向 SQL Server 驗證的存取令牌，作為使用者/密碼或 Windows 驗證的替代方案。

例如，這可用來連線到 SQL Azure DB 或 SQL Azure Managed Instance 或。 Service PrincipalManaged Identity

要使用的參數可以是字串，表示令牌或 PSAccessToken 物件，如執行 Get-AzAccessToken -ResourceUrl https://database.windows.net所傳回。

此參數是模組 v22 的新功能。

參數屬性

類型:	PSObject
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ColumnName

指定這個 Cmdlet 傳回之資料行名稱的陣列。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	ColumnToReturn

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ColumnOrder

指定數據行名稱的陣列，此 Cmdlet 會排序其傳回的數據行。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	排序依據

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ColumnOrderType

指定這個 Cmdlet 傳回之資料行的順序類型數位。此參數可接受的值為：

ASC。上升。
DESC。降。

您為此參數指定的值符合您在 ColumnOrder 參數中指定的數據行。此 Cmdlet 會忽略任何額外的值。

參數屬性

類型:	OrderType[]
預設值:	None
接受的值:	ASC, DESC
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ConnectionTimeout

指定要在逾時失敗前等候伺服器連線的秒數。逾時值必須是介於 0 到 65534 之間的整數。如果指定了 0，連線嘗試就不會逾時。

參數屬性

類型:	Int32
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ByName

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Credential

指定連接 SQL Server 的 PSCredential 物件。若要取得認證物件，請使用 Get-Credential Cmdlet。如需詳細資訊，請輸入 Get-Help Get-Credential。

參數屬性

類型:	PSCredential
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ByName

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DatabaseName

指定包含檢視的資料庫名稱。

如果您在資料庫或資料庫的子項目內容中執行此 Cmdlet，Cmdlet 會忽略此參數值。請為 Cmdlet 指定 IgnoreProviderContext 參數，以無論如何使用 DatabaseName 參數的值。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ByName

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Encrypt

線上到 SQL Server 時要使用的加密類型。

此值會對應至 Encrypt Microsoft.Data.SqlClient 驅動程式之 SqlConnection 物件上的屬性 SqlConnectionEncryptOption 。

在模組的 v22 中，預設值為 Optional （為了與 v21 相容）。在模組的 v23+ 中，預設值會是「強制」，這可能會為現有的腳本建立重大變更。

此參數是模組 v22 的新功能。

參數屬性

類型:	String
預設值:	None
接受的值:	Mandatory, Optional, Strict
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-HostNameInCertificate

用於驗證 SQL Server TLS/SSL 憑證的主機名稱。如果您的 SQL Server 實例已啟用強制加密，而且您想要使用主機名/shortname 連線到實例，則必須傳遞此參數。如果省略此參數，則必須將完整功能變數名稱（FQDN）傳遞至 -ServerInstance 才能連線到啟用強制加密的 SQL Server 實例。

此參數是模組 v22 的新功能。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-IgnoreProviderContext

指出此 Cmdlet 不會使用目前的內容來覆寫 ServerInstance、 DatabaseName、 SchemaName 和 ViewName 參數的值。如果您未指定此參數，Cmdlet 會盡可能忽略這些參數的值，而不是執行 Cmdlet 的內容。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ByName

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-InputObject

指定 SQL Server 管理物件（SMO）物件的陣列，代表這個 Cmdlet 讀取的檢視。

參數屬性

類型:	ScriptSchemaObjectBase[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ByObject

Position:	1
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-OutputAs

指定輸出的類型。

參數屬性

類型:	OutputTypeSingleTable
預設值:	None
接受的值:	DataSet, DataTable, DataRows
支援萬用字元:	False
不要顯示:	False
別名:	As

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Path

指定這個 Cmdlet 讀取之檢視的路徑。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ByPath

Position:	1
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-SchemaName

指定數據表的架構名稱。

如果您在資料庫或資料庫的子項目內容中執行此 Cmdlet，Cmdlet 會忽略此參數值。請為 Cmdlet 指定 IgnoreProviderContext 參數，以無論如何使用 SchemaName 參數的值。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ByName

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ServerInstance

指定 SQL Server 實例的名稱。針對預設實例，指定計算機名稱。針對具名實例，請使用格式 ComputerName\InstanceName。

如果您在資料庫或資料庫的子項目內容中執行此 Cmdlet，Cmdlet 會忽略此參數值。請為 Cmdlet 指定 IgnoreProviderContext 參數，以無論如何使用 ServerInstance 參數的值。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ByName

Position:	1
必要:	False
來自管線的值:	True
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-SuppressProviderContextWarning

指出此 Cmdlet 會隱藏指出 Cmdlet 使用提供者內容的警告訊息。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ByName

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-TopN

指定這個 Cmdlet 傳回的數據列數。如果您未指定此參數，Cmdlet 會傳回所有數據列。

參數屬性

類型:	Int64
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	第一

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-TrustServerCertificate

指出通道是否會在略過憑證鏈結以驗證信任時加密。

在模組的 v22 中，預設值為 $true （為了與 v21 相容）。在模組的 v23+ 中，預設值會是『$false』，這可能會為現有的腳本建立重大變更。

此參數是模組 v22 的新功能。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ViewName

指定這個 Cmdlet 讀取所在的檢視名稱。

如果您在資料庫或資料庫的子項目內容中執行此 Cmdlet，Cmdlet 會忽略此參數值。請為 Cmdlet 指定 IgnoreProviderContext 參數，以無論如何使用 ViewName 參數的值。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	名稱

參數集

ByName

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。如需詳細資訊，請參閱 about_CommonParameters。

輸入

System.String

意見反應

此頁面對您有幫助嗎？

共用方式為

Read-SqlViewData

語法

ByPath (預設值)

ByName

ByObject

Description

範例

範例 1：從檢視取得兩個數據列

範例 2：顯示整個檢視

範例 3：顯示選取的已排序數據行

參數

-AccessToken

參數屬性

參數集

-ColumnName

參數屬性

參數集

-ColumnOrder

參數屬性

參數集

-ColumnOrderType

參數屬性

參數集

-ConnectionTimeout

參數屬性

參數集

-Credential

參數屬性

參數集

-DatabaseName

參數屬性

參數集

-Encrypt

參數屬性

參數集

-HostNameInCertificate

參數屬性

參數集

-IgnoreProviderContext

參數屬性

參數集

-InputObject

參數屬性

參數集

-OutputAs

參數屬性

參數集

-Path

參數屬性

參數集

-SchemaName

參數屬性

參數集

-ServerInstance

參數屬性

參數集

-SuppressProviderContextWarning

參數屬性

參數集

-TopN

參數屬性

參數集

-TrustServerCertificate

參數屬性

參數集

-ViewName

參數屬性

參數集

CommonParameters

輸入

System.String

意見反應