Opmerkingen toevoegen aan gegevens en AI-assets

In dit artikel worden opmerkingen voor gegevens en AI-assets geïntroduceerd en wordt uitgelegd hoe u deze toevoegt. Opmerkingen kunnen u en andere gebruikers helpen bij het vinden en beheren van de gegevens en AI-assets die u nodig hebt.

Opmerkingen bevatten een metagegevensveld voor het toevoegen van aantekeningen aan uw beveiligbare objecten. U kunt opmerkingen toevoegen aan elk beveiligbaar object in Unity Catalog, zoals catalogi, schema's, tabellen, volumes, AI-modellen en meer. U kunt ook opmerkingen toevoegen aan tabelkolommen.

U kunt opmerkingen handmatig toevoegen of u kunt Databricks door AI gegenereerde opmerkingen voor u laten maken. Door AI gegenereerde opmerkingen (ook wel door AI gegenereerde documentatie genoemd) zijn beschikbaar voor tabellen en tabelkolommen. Zie Door AI gegenereerde opmerkingen toevoegen aan Unity Catalog-objecten.

Wanneer u opmerkingen wijzigt voor een Unity Catalog-tabel (of een Delta Lake-tabel in de verouderde Hive-metastore), registreert een SET TBLPROPERTIES bewerking in de tabelgeschiedenis de SQL-query die is gebruikt om de tabelopmerking te definiëren.

Voordat u begint

U moet voldoen aan de volgende vereisten om opmerkingen toe te voegen of te bewerken:

• Als u opmerkingen wilt toevoegen aan of bewerken voor een catalogus, schema, volume, model, share, ontvanger, provider, opslagreferentie, externe locatie of verbinding, moet u de eigenaar van het object zijn.
• Als u opmerkingen aan een tabel of kolom wilt toevoegen of bewerken, moet u de eigenaar zijn of de volgende bevoegdheden hebben:
  • MODIFY en SELECT op de tafel.
  • USE CATALOG en USE SCHEMA op de bovenliggende catalogus en het schema.
• U moet een SQL-warehouse of een ander rekenproces gebruiken dat ondersteuning biedt voor Unity Catalog (gedeelde of rekenkracht met één gebruiker).
• Als u door AI gegenereerde opmerkingen wilt gebruiken, moet uw werkruimte zijn ingeschakeld voor AI-ondersteunende functies. Zie Door AI gegenereerde opmerkingen toevoegen aan Unity Catalog-objecten.

Opmerkingen toevoegen en bewerken

U kunt opmerkingen toevoegen aan beveiligbare objecten of deze bewerken met behulp van SQL-opdrachten of Catalog Explorer.

Catalogusverkenner

1. Klik in de zijbalk van de werkruimte op Catalogus om Catalog Explorer te openen.

2. Zoek en selecteer het object waarop u een opmerking wilt plaatsen.

   Gegevens- en AI-objecten worden weergegeven en doorzoekbaar in het deelvenster Catalogus . Shares, opslagreferenties, externe locaties en verbindingen zijn toegankelijk via het menu dat wordt geopend wanneer u op het tandwielpictogram klikt.

3. Voeg een opmerking toe of bewerk een bestaande opmerking.

   • Als u een opmerking wilt toevoegen aan een tabel met behulp van door AI gegenereerde opmerkingen, bekijkt u de voorgestelde AI-opmerking in het rechterdeelvenster van het tabblad Overzicht . Het kan enkele seconden duren voordat deze wordt weergegeven. Accepteer deze als zodanig of Bewerk deze en sla het op.
   • Als u een opmerking wilt toevoegen aan een tabelkolom met behulp van door AI gegenereerde opmerkingen, klikt u op de knop AI genereren boven de kolomlijst. Databricks genereert opmerkingen voor elke kolom. Accepteer ze als zodanig of bewerk ze. Klik op het vinkje om de opmerking op te slaan.
   • Als u een opmerking wilt toevoegen aan een object dat door AI gegenereerde opmerkingen niet ondersteunt, klikt u op Opmerking toevoegen om een opmerking toe te voegen.
   • Als u een opmerking aan een tabelkolom wilt toevoegen zonder door AI gegenereerde opmerkingen te gebruiken, klikt u op het pictogram Opmerking toevoegen in de kolomrij.
   • Als er al een opmerking bestaat, wordt deze weergegeven in het rechterdeelvenster op het tabblad Overzicht of onder de objectnaam. Als het niet door AI gegenereerd is, klikt u op het bewerkingspictogram om het te bewerken.

U kunt Eenvoudige Markdown gebruiken om opmerkingen in de gebruikersinterface van Catalog Explorer te stylen. Markdown-stijl wordt niet weergegeven wanneer ze worden geretourneerd door DESCRIBE instructies. Alle basissyntaxis wordt ondersteund in Catalog Explorer, behalve afbeeldingen en er worden slechts twee kopniveaus weergegeven. Zie Basissyntaxis voor meer informatie.

Zie Ai gegenereerde opmerkingen toevoegen aan Unity Catalog-objecten voor meer informatie over door AI gegenereerde opmerkingen.

SQL

U kunt een SQL-opdracht gebruiken om een letterlijke tekenreeks als opmerking toe te voegen aan een beveiligbaar object in Unity Catalog en aan tabellen die worden beheerd in de verouderde Hive-metastore. De SQL-opdracht die u gebruikt, is afhankelijk van het object waarvoor u de opmerking wilt toevoegen of bewerken voor:

• Gebruik de COMMENT ON opdracht om een opmerking toe te voegen of bij te werken voor een bestaand beveiligbaar object behalve tabelkolommen. Zie OPMERKING AAN.

  U kunt ook de COMMENT optie gebruiken met de ALTER <object> opdracht voor het object (bijvoorbeeld ALTER TABLE). Zie het SQL-referentieartikel voor de ALTER <object> opdracht.

• Als u een kolomcommentaar voor een bestaande tabel wilt toevoegen of bijwerken, gebruikt u de ALTER TABLE opdracht met de ALTER COLUMN component en de COMMENT optie in de kolom. Zie ALTER TABLE en ALTER TABLE ... COLUMN-component.

• Als u een opmerking wilt toevoegen wanneer u een object maakt, gebruikt u de COMMENT optie met de CREATE <object> opdracht. Zie het SQL-referentieartikel voor de CREATE <object> opdracht die u wilt gebruiken.