Bagikan melalui


Read-SqlTableData

Membaca data dari tabel database SQL.

Sintaks

Read-SqlTableData
    [-TopN <Int64>]
    [-ColumnName <String[]>]
    [-ColumnOrder <String[]>]
    [-ColumnOrderType <OrderType[]>]
    [-OutputAs <OutputTypeSingleTable>]
    [[-Path] <String[]>]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [-ProgressAction <ActionPreference>]
    [<CommonParameters>]
Read-SqlTableData
    [-TableName <String>]
    [-TopN <Int64>]
    [-ColumnName <String[]>]
    [-ColumnOrder <String[]>]
    [-ColumnOrderType <OrderType[]>]
    [-OutputAs <OutputTypeSingleTable>]
    [-DatabaseName <String>]
    [-SchemaName <String>]
    [-IgnoreProviderContext]
    [-SuppressProviderContextWarning]
    [[-ServerInstance] <String[]>]
    [-Credential <PSCredential>]
    [-ConnectionTimeout <Int32>]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [-ProgressAction <ActionPreference>]
    [<CommonParameters>]
Read-SqlTableData
    [-TopN <Int64>]
    [-ColumnName <String[]>]
    [-ColumnOrder <String[]>]
    [-ColumnOrderType <OrderType[]>]
    [-OutputAs <OutputTypeSingleTable>]
    [-InputObject] <ScriptSchemaObjectBase[]>
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [-ProgressAction <ActionPreference>]
    [<CommonParameters>]

Deskripsi

cmdlet Read-SqlTableData membaca data yang disimpan dalam tabel database SQL. Anda dapat memilih kolom mana yang akan dibaca, membatasi jumlah baris, dan mengurutkan dan mengurutkan kolom.

Anda dapat menggunakan cmdlet ini dengan penyedia Windows PowerShell SQL. Cmdlet ini dapat menyimpulkan informasi seperti server, database, skema, dan tabel dari jalurnya saat ini.

Cmdlet ini mendukung format output berikut:

  • Dataset. Objek jenis System.Data.DataSet yang berisi satu tabel.
  • DataTable. Objek jenis System.Data.DataTable. Properti TableName objek ini sama dengan tabel yang dikueri cmdlet ini.
  • DataRows. Kumpulan objek System.Data.DateRow.

Contoh

Contoh 1: Mendapatkan tiga baris dari tabel

PS C:\> Read-SqlTableData -ServerInstance "MyServer\MyInstance" -DatabaseName "MyDatabase" -SchemaName "dbo" -TableName "MyTable" -TopN 3

Id Name   Amount
-- ----   ------
10 AAAAA  -1.2
11 BBBBB  1.2
12 CCCCC  -1.0

Perintah ini mendapatkan tiga baris pertama dari MyDatabase.dbo.MyTable tabel pada instans MyServer\MyInstance. Parameter TopN menentukan jumlah baris (3 dalam kasus ini).

Contoh 2: Menampilkan seluruh tabel

PS C:\> cd SQLSERVER:\sql\MyServer\MyInstance\Databases\MyDatabase\Tables\dbo.CSVTable
PS SQLSERVER:\sql\MyServer\MyInstance\Databases\MyDatabase\Tables\dbo.CSVTable> Read-SqlTableData

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

Perintah pertama mengubah lokasi menjadi tabel di penyedia SQLSERVER. Prompt perintah mencerminkan lokasi baru.

Contoh 3: Menampilkan kolom yang diurutkan yang dipilih

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

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

Parameter

-AccessToken

Token akses yang digunakan untuk mengautentikasi ke SQL Server, sebagai alternatif untuk pengguna/kata sandi atau Autentikasi Windows.

Ini dapat digunakan, misalnya, untuk menyambungkan ke SQL Azure DB dan SQL Azure Managed Instance menggunakan Service Principal atau Managed Identity.

Parameter yang digunakan dapat berupa string yang mewakili token atau objek PSAccessToken seperti yang dikembalikan dengan menjalankan Get-AzAccessToken -ResourceUrl https://database.windows.net.

Parameter ini baru dalam v22 modul.

Jenis:PSObject
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ColumnName

Menentukan array nama kolom yang dikembalikan cmdlet ini.

Jenis:String[]
Alias:ColumnToReturn
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ColumnOrder

Menentukan array nama kolom tempat cmdlet ini mengurutkan kolom yang dikembalikannya.

Jenis:String[]
Alias:OrderBy
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ColumnOrderType

Menentukan array jenis pesanan untuk kolom yang dikembalikan cmdlet ini. Nilai yang dapat diterima untuk parameter ini adalah:

  • ASC. Naik.
  • DESC. Turun.

Nilai yang Anda tentukan untuk parameter ini cocok dengan kolom yang Anda tentukan dalam parameter ColumnOrder. Cmdlet ini mengabaikan nilai tambahan apa pun.

Jenis:OrderType[]
Nilai yang diterima:ASC, DESC
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ConnectionTimeout

Menentukan jumlah detik untuk menunggu koneksi server sebelum kegagalan waktu habis. Nilai waktu habis harus berupa bilangan bulat antara 0 dan 65534. Jika 0 ditentukan, upaya koneksi tidak kehabisan waktu.

Jenis:Int32
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Credential

Menentukan objek PSCredential untuk koneksi ke SQL Server. Untuk mendapatkan objek kredensial, gunakan cmdlet Get-Credential. Untuk informasi selengkapnya, ketik Get-Help Get-Credential.

Jenis:PSCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DatabaseName

Menentukan nama database yang berisi tabel.

Jika Anda menjalankan cmdlet ini dalam konteks database atau item turunan database, cmdlet mengabaikan nilai parameter ini. Tentukan parameter IgnoreProviderContext untuk cmdlet untuk menggunakan nilai parameter DatabaseName.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Encrypt

Jenis enkripsi yang akan digunakan saat menyambungkan ke SQL Server.

Nilai ini memetakan ke properti EncryptSqlConnectionEncryptOption pada objek SqlConnection driver Microsoft.Data.SqlClient.

Dalam v22 modul, defaultnya adalah Optional (untuk kompatibilitas dengan v21). Dalam v23+ modul, nilai defaultnya adalah 'Wajib', yang dapat membuat perubahan yang melanggar untuk skrip yang ada.

Parameter ini baru dalam v22 modul.

Jenis:String
Nilai yang diterima:Mandatory, Optional, Strict
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-HostNameInCertificate

Nama host yang akan digunakan dalam memvalidasi sertifikat SQL Server TLS/SSL. Anda harus meneruskan parameter ini jika instans SQL Server Anda diaktifkan untuk Enkripsi Paksa dan Anda ingin terhubung ke instans menggunakan nama host/nama pendek. Jika parameter ini dihilangkan, maka meneruskan Nama Domain yang Sepenuhnya Memenuhi Syarat (FQDN) ke -ServerInstance diperlukan untuk terhubung ke instans SQL Server yang diaktifkan untuk Enkripsi Paksa.

Parameter ini baru dalam v22 modul.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-IgnoreProviderContext

Menunjukkan bahwa cmdlet ini tidak menggunakan konteks saat ini untuk mengambil alih nilai ServerInstance, DatabaseName, parameterSchemaName, dan TableName. Jika Anda tidak menentukan parameter ini, cmdlet mengabaikan nilai parameter ini, jika memungkinkan, demi konteks di mana Anda menjalankan cmdlet.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-InputObject

Menentukan array objek SQL Server Management Objects (SMO) yang mewakili tabel yang dibaca cmdlet ini.

Jenis:ScriptSchemaObjectBase[]
Position:1
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-OutputAs

Menentukan jenis output.

Jenis:OutputTypeSingleTable
Alias:As
Nilai yang diterima:DataSet, DataTable, DataRows
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Path

Menentukan jalur ke tabel yang dibaca cmdlet ini.

Jenis:String[]
Position:1
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ProgressAction

Menentukan bagaimana PowerShell merespons pembaruan kemajuan yang dihasilkan oleh skrip, cmdlet, atau penyedia, seperti bilah kemajuan yang dihasilkan oleh cmdlet Write-Progress. cmdlet Write-Progress membuat bilah kemajuan yang memperlihatkan status perintah.

Jenis:ActionPreference
Alias:proga
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-SchemaName

Menentukan nama skema untuk tabel.

Jika Anda menjalankan cmdlet ini dalam konteks database atau item turunan database, cmdlet mengabaikan nilai parameter ini. Tentukan parameter IgnoreProviderContext untuk cmdlet untuk menggunakan nilai parameter SchemaName.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ServerInstance

Menentukan nama instans SQL Server. Untuk instans default, tentukan nama komputer. Untuk instans bernama, gunakan format ComputerName\InstanceName.

Jika Anda menjalankan cmdlet ini dalam konteks database atau item turunan database, cmdlet mengabaikan nilai parameter ini. Tentukan parameter IgnoreProviderContext untuk cmdlet untuk menggunakan nilai parameter ServerInstance .

Jenis:String[]
Position:1
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-SuppressProviderContextWarning

Menunjukkan bahwa cmdlet ini menekan pesan peringatan yang menyatakan bahwa cmdlet menggunakan konteks penyedia.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-TableName

Menentukan nama tabel tempat cmdlet ini dibaca.

Jika Anda menjalankan cmdlet ini dalam konteks database atau item turunan database, cmdlet mengabaikan nilai parameter ini. Tentukan parameter IgnoreProviderContext untuk cmdlet untuk menggunakan nilai parameter TableName.

Jenis:String
Alias:Name
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-TopN

Menentukan jumlah baris data yang dikembalikan cmdlet ini. Jika Anda tidak menentukan parameter ini, cmdlet mengembalikan semua baris.

Jenis:Int64
Alias:First
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-TrustServerCertificate

Menunjukkan apakah saluran akan dienkripsi saat melewati rantai sertifikat untuk memvalidasi kepercayaan.

Dalam v22 modul, defaultnya adalah $true (untuk kompatibilitas dengan v21). Dalam v23+ modul, nilai defaultnya adalah '$false', yang dapat membuat perubahan yang melanggar untuk skrip yang ada.

Parameter ini baru dalam v22 modul.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Input

System.String[]