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 in een notebook of Databricks SQL-query. 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

1. Klik in de zijbalk op Catalogus.
2. Klik onder aan het scherm op Referenties voor externe gegevensopslag>.

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

1. Klik in de zijbalk op Catalogus.
2. Klik onder aan het scherm op Referenties voor externe gegevensopslag>.
3. 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 groepsnaam een spatie bevat, gebruikt u er back-ticks omheen (geen apostrofs).

Machtigingen verlenen om externe locaties te maken

Voer de volgende stappen uit om een externe locatie te maken met behulp van een opslagreferentie:

Catalogusverkenner

1. Klik in de zijbalk op Catalogus.
2. Klik onder aan het scherm op Referenties voor externe gegevensopslag>.
3. Klik op de naam van een opslagreferentie om de eigenschappen ervan te openen.
4. Klik op Machtigingen.
5. Als u machtigingen wilt verlenen aan gebruikers of groepen, selecteert u elke identiteit en klikt u vervolgens op Verlenen.
6. 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 groepsnaam een spatie bevat, gebruikt u er back-ticks omheen (geen apostrofs).

De eigenaar van een opslagreferentie wijzigen

De maker van een opslagreferentie is de oorspronkelijke eigenaar. Ga als volgt te werk om de eigenaar te wijzigen in een andere gebruiker of groep op accountniveau:

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:

1. Zoek in Catalog Explorer de opslagreferenties, klik op het menu Voor het object in de objectrij en selecteer Bewerken.
2. 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

1. Klik in de zijbalk op Catalogus.
2. Klik onder aan het scherm op Referenties voor externe gegevensopslag>.
3. Klik op de naam van een opslagreferentie om het bewerkingsdialoogvenster te openen.
4. 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

1. Klik in de zijbalk op Catalogus.
2. Klik onder aan het scherm op Referenties voor externe gegevensopslag>.
3. Klik op de naam van een opslagreferentie om het bewerkingsdialoogvenster te openen.
4. 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>;