Opslagreferenties beheren
In dit artikel wordt beschreven hoe u opslagreferenties kunt weergeven, weergeven, bijwerken, verlenen en verwijderen.
Databricks raadt u aan alleen CREATE EXTERNAL LOCATION
toegang te verlenen en geen andere bevoegdheden voor opslagreferenties.
In dit artikel wordt beschreven hoe u opslagreferenties beheert met behulp van Catalog Explorer en SQL-opdrachten. Zie de Databricks Terraform-documentatie en wat is de Databricks CLI?voor informatie over het gebruik van de Databricks CLI of Terraform.
Opslagreferenties vermelden
Als u de lijst met alle opslagreferenties in een metastore wilt weergeven, kunt u Catalog Explorer of een SQL-opdracht gebruiken.
Catalogusverkenner
- Klik in de zijbalk op Catalogus.
- Klik op de pagina Snelle toegang op de knop Externe gegevens >en ga naar het tabblad Referenties.
- Sorteer de referenties op doel (OPSLAG of SERVICE).
SQL
Voer de volgende opdracht uit in een notebook of de Databricks SQL-editor.
SHOW STORAGE CREDENTIALS;
Een opslagreferentie weergeven
Als u de eigenschappen van een opslagreferentie wilt weergeven, kunt u Catalog Explorer of een SQL-opdracht gebruiken.
Catalogusverkenner
- Klik in de zijbalk op Catalogus.
- Klik op de pagina Snelle toegang op de knop Externe gegevens >en ga naar het tabblad Referenties.
- Klik op de naam van een opslagreferentie om de eigenschappen ervan te bekijken.
SQL
Voer de volgende opdracht uit in een notebook of de Databricks SQL-editor. Vervang door <credential-name>
de naam van de referentie.
DESCRIBE STORAGE CREDENTIAL <credential-name>;
Subsidies weergeven op een opslagreferentie
Als u verleent op een opslagreferentie wilt weergeven, gebruikt u een opdracht zoals hieronder. U kunt de resultaten desgewenst filteren om alleen de subsidies voor de opgegeven principal weer te geven.
SHOW GRANTS [<principal>] ON STORAGE CREDENTIAL <storage-credential-name>;
Vervang de waarden van de tijdelijke aanduidingen:
<principal>
: het e-mailadres van de gebruiker op accountniveau of de naam van de groep op accountniveau aan wie de machtiging moet worden verleend.<storage-credential-name>
: De naam van een opslagreferentie.
Notitie
Als een groep of gebruikersnaam een spatie of @
symbool bevat, gebruikt u er back-ticks omheen (geen apostrofs). Bijvoorbeeld
financieel team
.
Machtigingen verlenen om externe locaties te maken
Voer de volgende stappen uit om een externe locatie te maken met behulp van een opslagreferentie:
Catalogusverkenner
- Klik in de zijbalk op Catalogus.
- Klik op de pagina Snelle toegang op de knop Externe gegevens >en ga naar het tabblad Referenties.
- Klik op de naam van een opslagreferentie om de pagina details te openen.
- Klik op Machtigingen.
- Als u machtigingen wilt verlenen aan gebruikers of groepen, selecteert u elke identiteit en klikt u vervolgens op Verlenen.
- Als u machtigingen van gebruikers of groepen wilt intrekken, selecteert u elke identiteit en klikt u op Intrekken.
SQL
Voer de volgende opdracht uit in een notebook of de SQL-queryeditor:
GRANT CREATE EXTERNAL LOCATION ON STORAGE CREDENTIAL <storage-credential-name> TO <principal>;
Vervang de waarden van de tijdelijke aanduidingen:
<principal>
: het e-mailadres van de gebruiker op accountniveau of de naam van de groep op accountniveau aan wie de machtiging moet worden verleend.<storage-credential-name>
: De naam van een opslagreferentie.
Notitie
Als een groep of gebruikersnaam een spatie of @
symbool bevat, gebruikt u er back-ticks omheen (geen apostrofs). Bijvoorbeeld
financieel team
.
De eigenaar van een opslagreferentie wijzigen
De maker van een opslagreferentie is de oorspronkelijke eigenaar. Als u de eigenaar wilt wijzigen in een andere gebruiker of groep op accountniveau, kunt u Catalog Explorer of een SQL-opdracht gebruiken.
Catalogusverkenner
- Klik in de zijbalk op Catalogus.
- Klik op de pagina Snelle toegang op de knop Externe gegevens >en ga naar het tabblad Referenties.
- Klik op de naam van een opslagreferentie om het bewerkingsdialoogvenster te openen.
- Klik naast Eigenaar.
- Typ om naar een principal te zoeken en selecteer deze.
- Klik op Opslaan.
SQL
Voer de volgende opdracht uit in een notebook of de Databricks SQL-editor. Vervang de waarden van de tijdelijke aanduidingen:
<credential-name>
: De naam van de referentie.<principal>
: het e-mailadres van een gebruiker op accountniveau of de naam van een groep op accountniveau.
ALTER STORAGE CREDENTIAL <credential-name> OWNER TO <principal>;
Een opslagreferentie markeren als alleen-lezen
Als u wilt dat gebruikers alleen-lezentoegang hebben tot alle gegevens die worden beheerd door een opslagreferentie, kunt u Catalog Explorer gebruiken om de opslagreferentie als alleen-lezen te markeren.
Als u opslagreferenties alleen-lezen maakt, betekent dit dat elke opslag die is geconfigureerd met die referentie alleen-lezen is.
U kunt opslagreferenties markeren als alleen-lezen wanneer u ze maakt.
U kunt Catalog Explorer ook gebruiken om de status Alleen-lezen te wijzigen nadat u een opslagreferentie hebt gemaakt:
- Zoek in Catalog Explorer de opslagreferenties, klik op het menu Voor het object in de objectrij en selecteer Bewerken.
- Selecteer in het dialoogvenster Bewerken de optie Alleen-lezen .
De naam van een opslagreferentie wijzigen
Als u de naam van een opslagreferentie wilt wijzigen, kunt u Catalog Explorer of een SQL-opdracht gebruiken.
Catalogusverkenner
- Klik in de zijbalk op Catalogus.
- Klik op de pagina Snelle toegang op de knop Externe gegevens >en ga naar het tabblad Referenties.
- Klik op de naam van een opslagreferentie om het bewerkingsdialoogvenster te openen.
- Wijzig de naam van de opslagreferentie en sla deze op.
SQL
Voer de volgende opdracht uit in een notebook of de Databricks SQL-editor. Vervang de waarden van de tijdelijke aanduidingen:
<credential-name>
: De naam van de referentie.<new-credential-name>
: Een nieuwe naam voor de referentie.
ALTER STORAGE CREDENTIAL <credential-name> RENAME TO <new-credential-name>;
Een opslagreferentie verwijderen
Als u een opslagreferentie wilt verwijderen (verwijderen), moet u de eigenaar zijn. Als u een opslagreferentie wilt verwijderen, kunt u Catalog Explorer of een SQL-opdracht gebruiken.
Catalogusverkenner
- Klik in de zijbalk op Catalogus.
- Klik op de pagina Snelle toegang op de knop Externe gegevens >en ga naar het tabblad Referenties.
- Klik op de naam van een opslagreferentie om het bewerkingsdialoogvenster te openen.
- Klik op de knop Verwijderen.
SQL
Voer de volgende opdracht uit in een notebook of de Databricks SQL-editor. Vervang door <credential-name>
de naam van de referentie. Gedeelten van de opdracht tussen haakjes zijn optioneel. Als de referentie standaard wordt gebruikt door een externe locatie, wordt deze niet verwijderd. Vervang door <credential-name>
de naam van de referentie.
IF EXISTS
retourneert geen fout als de referentie niet bestaat.
DROP STORAGE CREDENTIAL [IF EXISTS] <credential-name>;