Bagikan melalui


SQLTables

Berlaku untuk: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

SQLTables dapat dijalankan pada kursor server statis. Upaya untuk menjalankan SQLTables pada kursor yang dapat diperbarui (dinamis atau set kunci) akan mengembalikan SQL_SUCCESS_WITH_INFO menunjukkan bahwa jenis kursor telah diubah.

SQLTables melaporkan tabel dari semua database saat parameter CatalogName SQL_ALL_CATALOGS dan semua parameter lainnya berisi nilai default (pointer NULL).

Untuk melaporkan katalog, skema, dan jenis tabel yang tersedia, SQLTables menggunakan string kosong khusus (pointer byte panjang nol). String kosong bukan nilai default (penunjuk NULL).

Driver ODBC Klien Asli SQL Server mendukung informasi pelaporan untuk tabel di server tertaut dengan menerima nama dua bagian untuk parameter CatalogName : Linked_Server_Name.Catalog_Name.

SQLTables mengembalikan informasi tentang tabel apa pun yang namanya cocok dengan TableName dan dimiliki oleh pengguna saat ini.

Parameter SQLTables dan Table-Valued

Ketika atribut pernyataan SQL_SOPT_SS_NAME_SCOPE memiliki nilai SQL_SS_NAME_SCOPE_TABLE_TYPE, bukan nilai default SQL_SS_NAME_SCOPE_TABLE, SQLTables mengembalikan informasi tentang jenis tabel. Nilai TABLE_TYPE yang dikembalikan untuk jenis tabel di kolom 4 dari kumpulan hasil yang dikembalikan oleh SQLTables adalah JENIS TABEL. Untuk informasi selengkapnya tentang SQL_SOPT_SS_NAME_SCOPE, lihat SQLSetStmtAttr.

Tabel, tampilan, dan sinonim berbagi namespace umum yang berbeda dari namespace yang digunakan oleh jenis tabel. Meskipun tidak dimungkinkan untuk memiliki tabel dan tampilan dengan nama yang sama, dimungkinkan untuk memiliki tabel dan jenis tabel dengan yang sama dalam katalog dan skema yang sama.

Untuk informasi selengkapnya tentang parameter bernilai tabel, lihat Parameter Bernilai Tabel (ODBC).

Contoh

// Get a list of all tables in the current database.  
SQLTables(hstmt, NULL, 0, NULL, 0, NULL, 0, NULL,0);  
  
// Get a list of all tables in all databases.  
SQLTables(hstmt, (SQLCHAR*) "%", SQL_NTS, NULL, 0, NULL, 0, NULL,0);  
  
// Get a list of databases on the current connection's server.  
SQLTables(hstmt, (SQLCHAR*) "%", SQL_NTS, (SQLCHAR*)"", 0, (SQLCHAR*)"",  
    0, NULL, 0);  

Lihat Juga

Fungsi SQLTables
Detail Implementasi ODBC API