TABELLEN WEERGEVEN DIE ZIJN VERWIJDERD
Van toepassing op: Databricks SQL Databricks Runtime 12.2 LTS en hoger
Belangrijk
Deze functie is beschikbaar als openbare preview.
Met deze opdracht worden alle tabellen weergegeven die in het schema in Unity Catalog zijn verwijderd, maar die nog steeds kunnen worden opgeslagen. In het bijzonder worden alle verwijderde tabellen in de bewaarperiode vermeld (standaard is 7 dagen). Als het schema of de catalogus is verwijderd, treedt er een fout op. Als er geen schema is opgegeven, worden de tabellen geretourneerd uit het huidige schema.
Met de opdracht worden alleen tabellen weergegeven die de aanvrager kan undropen.
Daarom hebben metastore-/catalogus-/schema-eigenaren bevoegdheden om alle verwijderde tabellen weer te geven binnen hun respectieve beveiligbare eigendom.
Gebruikers met eigendom op tabelniveau kunnen alleen tabellen weergeven waarvan ze eigenaar zijn in de invoercatalogus/het schema zolang ze de USE CATALOG
bevoegdheid hebben voor de bovenliggende catalogus en de USE SCHEMA
bevoegdheid voor het bovenliggende schema.
Syntaxis
SHOW TABLES DROPPED [ { FROM | IN } schema_name ] [ LIMIT maxResults ]
Parameters
-
Hiermee geeft u de schemanaam van waaruit tabellen moeten worden weergegeven. Als dit niet is opgegeven, gebruikt u het huidige schema. Als het schema of de catalogus niet bestaat of is verwijderd, wordt er een SCHEMA_NOT_FOUND fout gegenereerd.
maxResult
Een letterlijk geheel getal dat het aantal geretourneerde tabellen beperkt.
Retouren
De opdracht produceert een rapport van de lijst met tabellen met de volgende kolommen:
Naam | Gegevenstype | Null-waarde toegestaan | Beschrijving" |
---|---|---|---|
catalogName | STRING | nee | De catalogusnaam van de vermelde tabel. |
schemaName | STRING | nee | De schemanaam van de vermelde tabel. |
tableName | STRING | nee | De naam van de verwijderde tabel |
tableId | STRING | nee | De tabel-id die kan worden gebruikt om een specifieke versie van de verwijderde tabel te identificeren en los te laten. |
tableType | STRING | nee | Het type van de verwijderde tabel in Unity Catalog |
deletedAt | STRING | nee | Het tijdstip waarop de tabel werd verwijderd. |
createdAt | STRING | nee | Het tijdstip waarop de tabel is gemaakt. |
updatedAt | STRING | nee | Het tijdstip waarop de tabel voor het laatst is bijgewerkt. |
createdBy | STRING | nee | De principal die de tabel heeft gemaakt. |
eigenaar | STRING | nee | De principal die eigenaar is van de tabel. |
reactie | STRING | ja | De optionele tabelcommentaar. |
Voorbeelden
— List dropped tables from an existing schema + catalog.
> USE CATALOG default;
> USE SCHEMA my_schema;
> CREATE TABLE my_table_1;
> CREATE TABLE my_table_2;
> DROP TABLE my_table_1;
> SHOW TABLES DROPPED;
catalogname schemaname tablename tableid tabletype deletedat createdat updatedat createdby owner comment
----------- ---------- ---------- ------- --------- ----------------------------- ----------------------------- ----------------------------- ------------- ------------- -------
default my_schema my_table_1 <uuid> managed 2023-05-03 AD at 18:17:56 UTC 2023-05-03 AD at 18:17:00 UTC 2023-05-03 AD at 18:17:00 UTC alf@melmak.et alf@melmak.et
-- Create a new table with name `my_table_1` since other was dropped.
> CREATE TABLE my_table_1;
> DROP TABLE my_table_1;
> SHOW TABLES DROPPED IN default.my_schema;
catalogname schemaname tablename tableid tabletype deletedat createdat updatedat createdby owner comment
----------- ---------- ---------- ------- --------- ----------------------------- ----------------------------- ----------------------------- ------------- ------------- -------
default my_schema my_table_1 <uuid> managed 2023-05-03 AD at 18:17:56 UTC 2023-05-03 AD at 18:17:00 UTC 2023-05-03 AD at 18:17:00 UTC alf@melmak.et alf@melmak.et
— List dropped tables when some are past the retention period.
> USE CATALOG default;
> USE SCHEMA my_schema;
> CREATE TABLE my_table_1;
> DROP TABLE my_table_1;
-- Wait 8 days (1 more than 7 day retention period)
> SHOW TABLES DROPPED;
catalogname schemaname tablename tableid tabletype deletedat createdat updatedat createdby owner comment
----------- ---------- ---------- ------- --------- ----------------------------- ----------------------------- ----------------------------- ------------- ------------ -------