SQLTablePrivileges – funkce

Soulad
Zavedená verze: ODBC 1.0 Soulad standardů: ODBC

Shrnutí
SQLTablePrivileges vrací seznam tabulek a privilegia přiřazená každé tabulce. Ovladač vrací informace jako výslednou sadu na daném příkazu.

Syntax

  
SQLRETURN SQLTablePrivileges(  
     SQLHSTMT      StatementHandle,  
     SQLCHAR *     CatalogName,  
     SQLSMALLINT   NameLength1,  
     SQLCHAR *     SchemaName,  
     SQLSMALLINT   NameLength2,  
     SQLCHAR *     TableName,  
     SQLSMALLINT   NameLength3);  

Arguments

StatementHandle
[Vstup] Popisovač příkazu

CatalogName
[Vstup] Katalog stolů. Pokud ovladač podporuje katalogy pro některé tabulky, ale ne pro jiné, například když ovladač získává data z různých DBMS, prázdný řetězec ("") označuje tabulky, které katalogy nemají. CatalogName nemůže obsahovat vzor vyhledávání řetězců.

Pokud je atribut SQL_ATTR_METADATA_ID příkazu nastaven na SQL_TRUE, CatalogName je považován za identifikátor a jeho případ není významný. Pokud je to SQL_FALSE, CatalogName je běžný argument; Je brána doslovně a její případ je významný. Další informace naleznete v tématu Argumenty funkce katalogu.

NameLength1
[Vstup] Délka znaků *CatalogName.

Název schématu
[Vstup] Vzor vyhledávání řetězců pro názvy schémat. Pokud ovladač podporuje schémata pro některé tabulky, ale ne pro jiné, například když ovladač získává data z různých DBMS, prázdný řetězec ("") označuje tabulky, které schémata nemají.

Pokud je atribut SQL_ATTR_METADATA_ID příkazu nastaven na SQL_TRUE, SchemaName je považován za identifikátor a jeho případ není významný. Pokud je to SQL_FALSE, SchemaName je argument hodnoty vzoru; Je brána doslovně a její případ je významný.

NameLength2
[Vstup] Délka znaků *SchemaName.

TableName
[Vstup] Vzor vyhledávání řetězců pro názvy tabulek.

Pokud je atribut SQL_ATTR_METADATA_ID příkazu nastaven na SQL_TRUE, TableName je považován za identifikátor a jeho případ není významný. Pokud je SQL_FALSE, TableName je argument vzorové hodnoty; Je brána doslovně a její případ je významný.

NameLength3
[Vstup] Délka znaků *TableName.

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_STILL_EXECUTING, SQL_ERROR nebo SQL_INVALID_HANDLE.

Diagnostics

Když SQLTablePrivileges vrátí SQL_ERROR nebo SQL_SUCCESS_WITH_INFO, lze získat přidruženou hodnotu SQLSTATE voláním SQLGetDiagRec s HandleType of SQL_HANDLE_STMT a Handle of StatementHandle. Následující tabulka uvádí hodnoty SQLSTATE, které SQLTablePrivileges běžně vrací, a vysvětluje každou z nich v kontextu této funkce; notace "(DM)" předchází popisům SQLstavů vráceným Správcem ovladačů. Návratový kód přidružený ke každé hodnotě SQLSTATE je SQL_ERROR, pokud není uvedeno jinak.

SQLSTATE	Error	Description
01000	Obecné upozornění	Informační zpráva specifická pro řidiče (Funkce vrátí SQL_SUCCESS_WITH_INFO.)
08S01	Selhání komunikačního propojení	Komunikační propojení mezi ovladačem a zdrojem dat, ke kterému byl ovladač připojen, selhalo před dokončením zpracování funkce.
24000	Neplatný stav kurzoru	Na StatementHandle byl otevřený kurzor a byly volány SQLFetch nebo SQLFetchScroll . Tuto chybu vrátí správce ovladačů, pokud SQLFetch nebo SQLFetchScroll nevrátil SQL_NO_DATA, a ovladač ji vrátí, pokud SQLFetch nebo SQLFetchScroll vrátily SQL_NO_DATA. Na StatementHandle byl otevřený kurzor, ale SQLFetch nebo SQLFetchScroll nebyly volány.
40001	Selhání serializace	Transakce byla vrácena zpět kvůli vzájemnému zablokování prostředku s jinou transakcí.
40003	Neznámé dokončování příkazů	Přidružené připojení se nezdařilo během provádění této funkce a stav transakce nelze určit.
HY000	Obecná chyba	Došlo k chybě, pro kterou nebyla definována žádná specifická funkce SQLSTATE a pro kterou nebyla definována žádná implementace sqlSTATE. Chybová zpráva vrácená nástrojem SQLGetDiagRec v vyrovnávací paměti *MessageText popisuje chybu a její příčinu.
HY001	Chyba přidělení paměti	Ovladač nemohl přidělit paměť potřebnou k podpoře provádění nebo dokončení funkce.
HY008	Operace byla zrušena.	Asynchronní zpracování bylo povoleno pro StatementHandle. Funkce SQLTablePrivileges byla vyvolána a před dokončením spuštění byl na StatementHandlevyvolán SQLCancel nebo SQLCancelHandle. Poté byla funkce SQLTablePrivileges znovu vyvolána na StatementHandle. Funkce SQLTablePrivileges byla vyvolána a před dokončením jejího spuštění byl na StatementHandle vyvolán SQLCancel nebo SQLCancelHandle z jiného vlákna v multithread aplikaci.
HY009	Neplatné použití ukazatele null	Atribut SQL_ATTR_METADATA_ID příkazu byl nastaven na SQL_TRUE, argument CatalogName byl nulový ukazatel a SQL_CATALOG_NAME InfoType vrací, že jsou podporována jména katalogů. (DM) Atribut SQL_ATTR_METADATA_ID příkazu byl nastaven na SQL_TRUE a argument SchemaName nebo TableName byl nulový ukazatel.
HY010	Chyba posloupnosti funkcí	(DM) Byla volána asynchronně spuštěná funkce pro popisovač připojení, který je přidružen k StatementHandle. Tato asynchronní funkce byla stále vykonávána, když byla volána funkce SQLTablePrivileges . (DM) SQLExecute, SQLExecDirect nebo SQLMoreResults byl volána pro StatementHandle a vrácena SQL_PARAM_DATA_AVAILABLE. Tato funkce byla volána před načtením dat pro všechny streamované parametry. (DM) Pro PříkazHandle byla volána asynchronně spuštěná funkce (ne tato) a při zavolání této funkce se stále spouštěla. (DM) SQLExecute, SQLExecDirect, SQLBulkOperations nebo SQLSetPos byly volány pro StatementHandle a vráceny SQL_NEED_DATA. Tato funkce byla volána před odesláním dat pro všechny parametry provádění dat nebo sloupce.
HY013	Chyba správy paměti	Volání funkce nelze zpracovat, protože základní objekty paměti nelze získat přístup, pravděpodobně kvůli nedostatku paměti.
HY090	Neplatná délka řetězce nebo vyrovnávací paměti	(DM) Hodnota jednoho z argumentů délky názvu byla menší než 0, ale nebyla rovna SQL_NTS. Hodnota jednoho z argumentů délky názvu překročila maximální hodnotu délky příslušného kvalifikátoru nebo jména.
HY117	Připojení je pozastaveno kvůli neznámému stavu transakce. Jsou povoleny pouze funkce pro odpojení a jen pro čtení.	(DM) Pro více informací o pozastaveném stavu viz SQLEndTran Function.
HYC00	Nepovinná funkce není implementována.	Byl specifikován katalog, ale ovladač nebo datový zdroj katalogy nepodporuje. Bylo specifikováno schéma a ovladač nebo zdroj dat schémata nepodporuje. Pro schéma tabulky, název tabulky nebo sloupce byl specifikován vzor vyhledávání řetězců a zdroj dat nepodporuje vyhledávací vzory pro jeden nebo více těchto argumentů. Ovladač ani zdroj dat nepodporuje kombinaci aktuálních nastavení atributů SQL_ATTR_CONCURRENCY a SQL_ATTR_CURSOR_TYPE příkazu. Atribut příkazu SQL_ATTR_USE_BOOKMARKS byl nastaven na SQL_UB_VARIABLE a atribut příkazu SQL_ATTR_CURSOR_TYPE byl nastaven na typ kurzoru, pro který ovladač nepodporuje záložky.
HYT00	Vypršel časový limit.	Platnost časového limitu dotazu vypršela, než zdroj dat vrátil sadu výsledků. Časový limit je nastavený prostřednictvím sqlSetStmtAttr SQL_ATTR_QUERY_TIMEOUT.
HYT01	Vypršel časový limit připojení	Platnost časového limitu připojení vypršela, než zdroj dat odpověděl na žádost. Časový limit připojení je nastavený prostřednictvím sqlSetConnectAttr SQL_ATTR_CONNECTION_TIMEOUT.
IM001	Ovladač tuto funkci nepodporuje.	(DM) Ovladač přidružený k StatementHandle nepodporuje funkci.
IM017	Dotazování je zakázané v asynchronním režimu oznámení.	Při každém použití modelu oznámení je dotazování zakázané.
IM018	K dokončení předchozí asynchronní operace na tomto popisovači nebyla volána funkce SQLCompleteAsync.	Pokud předchozí volání funkce na popisovači vrátí SQL_STILL_EXECUTING a pokud je povolen režim oznámení, musí být sqlCompleteAsync volán na popisovači, aby bylo možné provést následné zpracování a dokončit operaci.

Comments

Argumenty SchemaName a TableName přijímají vyhledávací vzory. Pro více informací o platných vyhledávacích vzorcích viz Argumenty hodnoty vzoru.

SQLTablePrivileges vrací výsledky jako standardní sadu výsledků, seřazenou podle TABLE_CAT, TABLE_SCHEM, TABLE_NAME, PRIVILEGE a GRANTEE.

Pro určení skutečných délek sloupců TABLE_CAT, TABLE_SCHEM a TABLE_NAME může aplikace volat SQLGetInfo s možnostmi SQL_MAX_CATALOG_NAME_LEN, SQL_MAX_SCHEMA_NAME_LEN a SQL_MAX_TABLE_NAME_LEN.

Note

Další informace o obecném použití, argumentech a vrácených datech funkcí katalogu ODBC naleznete v tématu Funkce katalogu.

Následující sloupce byly přejmenovány pro ROZHRANÍ ODBC 3.x. Změny názvů sloupců neovlivňují zpětnou kompatibilitu, protože aplikace se vážou podle čísla sloupce.

Sloupec ODBC 2.0	Sloupec ODBC 3.x
kvalifikátor_tabulky	TABLE_CAT
Vlastník tabulky	TABLE_SCHEM

Následující tabulka uvádí sloupce v sadě výsledků. Další sloupce za sloupcem 7 (IS_GRANTABLE) může ovladač definovat. Aplikace by měla získat přístup ke sloupcům specifickým pro ovladač odpočítáváním od konce výsledné množiny místo explicitního určení ordinální pozice. Další informace naleznete v tématu Data vrácená funkcemi katalogu.

Název sloupce	Číslo sloupce	Datový typ	Comments
TABLE_CAT (ODBC 1.0)	1	Varchar	Název katalogu; NULL, pokud není relevantní pro datový zdroj. Pokud ovladač podporuje katalogy pro některé tabulky, ale ne pro jiné, například když ovladač získává data z různých DBMS, vrátí prázdný řetězec ("") pro tabulky, které katalogy nemají.
TABLE_SCHEM (ODBC 1.0)	2	Varchar	Schéma: NULL, pokud není relevantní pro datový zdroj. Pokud ovladač podporuje schémata pro některé tabulky, ale ne pro jiné, například když ovladač získává data z různých DBMS, vrátí prázdný řetězec ("") pro tabulky, které schémata nemají.
TABLE_NAME (ODBC 1.0)	3	Varchar, ne NULL	Název tabulky
GRANTOR (ODBC 1.0)	4	Varchar	Jméno uživatele, který mu toto oprávnění udělil; NULL, pokud není relevantní pro datový zdroj. Pro všechny řádky, kde je hodnota ve sloupci GRANTEE vlastníkem objektu, bude sloupec GRANTOR "_SYSTEM".
PŘÍJEMCE (ODBC 1.0)	5	Varchar, ne NULL	Jméno uživatele, kterému bylo toto oprávnění uděleno.
PRIVILEGIUM (ODBC 1.0)	6	Varchar, ne NULL	Právo na stůl. Může jít o jednu z následujících nebo o privilegium specifické pro datový zdroj. SELECT: Příjemce grantu má oprávnění získat data pro jeden nebo více sloupců tabulky. INSERT: Příjemce grantu je oprávněn vložit do tabulky nové řádky obsahující data pro jeden nebo více sloupců. UPDATE: Příjemce grantu má oprávnění aktualizovat data v jednom nebo více sloupcích tabulky. DELETE: Příjemce grantu může z tabulky mazat řádky dat. REFERENCE: Příjemce grantu je oprávněn odkazovat na jeden nebo více sloupců tabulky v rámci omezení (například jedinečné, referenční nebo tabulkové kontrolní omezení). Rozsah jednání, který příjemci dané tabulkové privilegium povoluje, závisí na zdroji dat. Například toto oprávnění může umožnit příjemci aktualizovat všechny sloupce v tabulce na jednom datovém zdroji a pouze ty sloupce, UPDATE pro které má grantor oprávnění UPDATE , na jiném datovém zdroji.
IS_GRANTABLE (ODBC 1.0)	7	Varchar	Uvádí, zda má příjemce oprávnění udělit toto privilegium ostatním uživatelům; "ANO", "NE" nebo NULL, pokud nejsou známé nebo se nevztahují na datový zdroj. Privilegium je buď udělitelné, nebo neudělitelné, ale ne obojí. Výsledná sada vrácená pomocí SQLColumnPrivileges nikdy nebude obsahovat dva řádky, pro které všechny sloupce kromě sloupce IS_GRANTABLE obsahují stejnou hodnotu.

Příklad kódu

Pro příklad kódu podobné funkce viz SQLColumns.

Související funkce

Informace o	Podívejte se
Vytvoření vazby vyrovnávací paměti ke sloupci v sadě výsledků	SQLBindCol – funkce
Zrušení zpracování příkazů	SQLCancel – funkce
Vrácení oprávnění pro sloupec nebo sloupce	Funkce SQLColumnPrivileges
Vrácení sloupců v tabulce nebo tabulkách	SQLColumns Function
Načítání jednoho řádku nebo bloku dat pouze ve směru dopředu	Funkce SQLFetch
Načtení bloku dat nebo procházení sady výsledků	SQLFetchScroll – funkce
Statistiky a indexy v tabulkách	Funkce SQLStatistics
Vrácení seznamu tabulek ve zdroji dat	Funkce SQLTables

Viz také

Referenční rozhraní ODBC API
Soubory hlaviček ODBC