Udostępnij za pośrednictwem

Interfejs wiersza polecenia wykazu aparatu Unity (starsza wersja)

  • Artykuł

Ważne

Ta dokumentacja została wycofana i może nie zostać zaktualizowana.

Te informacje dotyczą starszych wersji interfejsu wiersza polecenia usługi Databricks w wersji 0.18 i poniżej. Usługa Databricks zaleca użycie nowszego interfejsu wiersza polecenia usługi Databricks w wersji 0.205 lub nowszej. Zobacz Co to jest interfejs wiersza polecenia usługi Databricks?. Aby znaleźć swoją wersję interfejsu wiersza polecenia usługi Databricks, uruchom polecenie databricks -v.

Aby przeprowadzić migrację z interfejsu wiersza polecenia usługi Databricks w wersji 0.18 lub nowszej do interfejsu wiersza polecenia usługi Databricks w wersji 0.205 lub nowszej, zobacz Migracja interfejsu wiersza polecenia usługi Databricks.

Uwaga

Interfejs wiersza polecenia wykazu aparatu Unity jest eksperymentalny.

Interfejs wiersza polecenia wykazu aparatu Unity wymaga interfejsu wiersza polecenia usługi Databricks (starsza wersja) 0.17.0 lub nowszego skonfigurowanego z uwierzytelnianiem. Aby zaktualizować interfejs wiersza polecenia usługi Databricks lub wyświetlić zainstalowaną wersję, zobacz Aktualizowanie interfejsu wiersza polecenia.

Przykładowe wartości opcji i pola w poniższych przykładach są przeznaczone tylko do celów ilustracyjnych.

Użyj interfejsu wiersza polecenia wykazu aparatu Unity, aby pracować z:

  • Zasoby wykazu aparatu Unity, takie jak magazyny metadanych, poświadczenia magazynu, lokalizacje zewnętrzne, katalogi, schematy, tabele i ich uprawnienia.
  • Zasoby udostępniania różnicowego, takie jak udziały, adresaci i dostawcy.

Uruchamiasz podpolecenia interfejsu wiersza polecenia wykazu aparatu Unity, dołączając je do polecenia databricks unity-catalog. Te podpolecenia wywołają interfejs API wykazu aparatu Unity, który obejmuje również interfejs API udostępniania różnicowego.

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog --help.

Wyjście:

Usage: databricks unity-catalog [OPTIONS] COMMAND [ARGS]...

  Utility to interact with Databricks Unity Catalog.

Options:
  -v, --version  0.17.1
  -h, --help     Show this message and exit.

Commands:
  catalogs
  external-locations
  lineage
  metastores
  permissions
  providers
  recipients
  schemas
  shares
  storage-credentials
  tables

Magazyny metadanych

unity-catalog metastores Użyj podpolecenia, aby pracować z magazynami metadanych.

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog metastores --help.

Tworzenie magazynu metadanych

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog metastores create --help. Zobacz również Tworzenie magazynu metadanych wykazu aparatu Unity.

Uwaga

Utworzenie magazynu metadanych nie powoduje automatycznego skojarzenia magazynu metadanych z obszarem roboczym ani poświadczenie magazynu. Aby wykonać te zadania, zobacz Łączenie magazynu metadanych z obszarem roboczym, Tworzenie poświadczeń magazynu i Aktualizowanie ustawień magazynu metadanych.

Jeśli uruchomisz to polecenie w obszarze roboczym, który ma już przypisany magazyn metadanych, zaktualizujesz przypisany magazyn metadanych tego obszaru roboczego.

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog metastores assign --help.

databricks unity-catalog metastores assign --workspace-id 1234567890123456 \
                                           --metastore-id 12a345b6-7890-1cd2-3456-e789f0a12b34 \
                                           --default-catalog-name main

Aby uzyskać identyfikator obszaru roboczego, zobacz Nazwy wystąpień obszaru roboczego, adresy URL i identyfikatory.

Aby uzyskać identyfikator magazynu metadanych, uruchom polecenie databricks unity-catalog metastores get-summary. Aby zapoznać się z przykładem, zobacz Pobieranie podsumowanych informacji o bieżącym magazynie metadanych.

Wyjście:

{}

Zobacz również Tworzenie magazynu metadanych wykazu aparatu Unity.

Aktualizowanie ustawień magazynu metadanych

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog metastores update --help.

databricks unity-catalog metastores update --id 12a345b6-7890-1cd2-3456-e789f0a12b34 \
                                           --json-file update-metastore.json

Aby uzyskać identyfikator magazynu metadanych, uruchom polecenie databricks unity-catalog metastores get-summary. Aby zapoznać się z przykładem, zobacz Pobieranie podsumowanych informacji o bieżącym magazynie metadanych.

update-metastore.json:

{
  "storage_root_credential_id": "12a345b6-7890-1cd2-3456-e789f0a12b34"
}

Aby uzyskać identyfikator poświadczeń głównego magazynu, zobacz Uzyskiwanie informacji o poświadczeniu magazynu.

Wyświetlanie listy dostępnych magazynów metadanych

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog metastores list --help.

databricks unity-catalog metastores list

Uzyskiwanie informacji o magazynie metadanych

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog metastores get --help.

databricks unity-catalog metastores get --id 12a345b6-7890-1cd2-3456-e789f0a12b34

Aby uzyskać identyfikator magazynu metadanych, uruchom polecenie databricks unity-catalog metastores get-summary. Aby zapoznać się z przykładem, zobacz Pobieranie podsumowanych informacji o bieżącym magazynie metadanych.

Pobieranie podsumowanych informacji o bieżącym magazynie metadanych

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog metastores get-summary --help.

databricks unity-catalog metastores get-summary

Pobieranie bieżącego przypisania magazynu metadanych dla obszaru roboczego

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog metastores get-assignment --help.

databricks unity-catalog metastores get-assignment

Wyjście:

{
  "workspace_id": 1234567890123456,
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "default_catalog_name": "main"
}

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog metastores unassign --help.

databricks unity-catalog metastores unassign --workspace-id 1234567890123456 \
                                             --metastore-id 12a345b6-7890-1cd2-3456-e789f0a12b34

Aby uzyskać identyfikator obszaru roboczego, zobacz Nazwy wystąpień obszaru roboczego, adresy URL i identyfikatory.

Aby uzyskać identyfikator magazynu metadanych, uruchom polecenie databricks unity-catalog metastores get-summary. Aby zapoznać się z przykładem, zobacz Pobieranie podsumowanych informacji o bieżącym magazynie metadanych.

Wyjście:

{}

Usuwanie magazynu metadanych

Ostrzeżenie

Przed usunięciem magazynu metadanych należy usunąć wszystkie obszary robocze korzystające z magazynu metadanych lub usunąć link magazynu metadanych do tych obszarów roboczych. Skontaktuj się z pomocą techniczną usługi Azure Databricks, aby uzyskać pomoc dotyczącą usuwania linków magazynu metadanych z obszarów roboczych.

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog metastores delete --help.

Aby przymusowo usunąć magazyn metadanych, użyj --force opcji .

databricks unity-catalog metastores delete --id 12a345b6-7890-1cd2-3456-e789f0a12b34

Aby uzyskać identyfikator magazynu metadanych, uruchom polecenie databricks unity-catalog metastores get-summary. Aby zapoznać się z przykładem, zobacz Pobieranie podsumowanych informacji o bieżącym magazynie metadanych.

Jeśli operacja zakończy się pomyślnie, żadne wyniki nie zostaną zwrócone.

Poświadczenia magazynu

Użyj polecenia podrzędnego unity-catalog storage-credentials , aby pracować z poświadczeniami magazynu. Zobacz Tworzenie poświadczeń magazynu na potrzeby nawiązywania połączenia z usługą Azure Data Lake Storage Gen2.

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog storage-credentials --help.

Tworzenie poświadczeń magazynu

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog storage-credentials create --help.

Zobacz również Tworzenie poświadczeń magazynu na potrzeby nawiązywania połączenia z usługą Azure Data Lake Storage Gen2.

Aktualizowanie ustawień poświadczeń magazynu

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog storage-credentials update --help.

Wyświetlanie listy dostępnych poświadczeń magazynu

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog storage-credentials list --help.

databricks unity-catalog storage-credentials list

Uzyskiwanie informacji o poświadczenie magazynu

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog storage-credentials get --help.

databricks unity-catalog storage-credentials get --name my-storage-root-credential

Usuwanie poświadczeń magazynu

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog storage-credentials delete --help.

Aby przymusowo usunąć poświadczenia magazynu, użyj --force opcji .

databricks unity-catalog storage-credentials delete --name my-storage-root-credential

Jeśli operacja zakończy się pomyślnie, żadne wyniki nie zostaną zwrócone.

Lokalizacje zewnętrzne

unity-catalog external-locations Użyj podpolecenia, aby pracować z lokalizacjami zewnętrznymi. Zobacz Tworzenie lokalizacji zewnętrznej w celu połączenia magazynu w chmurze z usługą Azure Databricks.

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog external-locations --help.

Tworzenie lokalizacji zewnętrznej

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog external-locations create --help. Zobacz również Tworzenie lokalizacji zewnętrznej w celu połączenia magazynu w chmurze z usługą Azure Databricks.

Weryfikowanie lokalizacji zewnętrznej i pary poświadczeń

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog external-locations validate --help.

Weryfikowanie nazwy lokalizacji zewnętrznej i pary poświadczeń po ich utworzeniu

databricks unity-catalog external-locations validate --name my-external-location \
                                                     --cred-name my-storage-root-credential

Wyjście:

{
  "isDir": true,
  "results": [
    {
      "operation": "READ",
      "result": "PASS"
    },
    {
      "operation": "LIST",
      "result": "PASS"
    },
    {
      "operation": "WRITE",
      "result": "PASS"
    },
    {
      "operation": "DELETE",
      "result": "PASS"
    }
  ]
}

Aktualizowanie ustawień lokalizacji zewnętrznej

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog external-locations update --help.

databricks unity-catalog external-locations update --name my-external-location \
                                                   --json-file update-external-location.json

udpate-external-location.json:

{
  "name": "my-external-location-2"
}

Wyświetlanie listy dostępnych lokalizacji zewnętrznych

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog external-locations list --help.

databricks unity-catalog external-locations list

Uzyskiwanie informacji o lokalizacji zewnętrznej

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog external-locations get --help.

databricks unity-catalog external-locations get --name my-external-location

Usuwanie lokalizacji zewnętrznej

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog external-locations delete --help.

Aby przymusowo usunąć lokalizację zewnętrzną --force , użyj opcji .

databricks unity-catalog external-locations delete --name my-external-location

Jeśli operacja zakończy się pomyślnie, żadne wyniki nie zostaną zwrócone.

Katalogi

unity-catalog catalogs Użyj podpolecenia, aby pracować z wykazami.

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog catalogs --help.

Tworzenie katalogu

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog catalogs create --help. Zobacz też Tworzenie katalogów.

databricks unity-catalog catalogs create --name my-catalog

Wyjście:

{
  "name": "my-catalog",
  "owner": "someone@example.com",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "created_at": 1656113178995,
  "created_by": "someone@example.com",
  "updated_at": 1656113178995,
  "updated_by": "someone@example.com",
  "catalog_type": "MANAGED_CATALOG"
}

Aktualizowanie ustawień wykazu

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog catalogs update --help.

databricks unity-catalog catalogs update --name my-catalog \
                                         --json-file update-catalog.json

update-catalog.json:

{
  "name": "my-catalog-2",
  "owner": "someone@example.com"
}

Wyjście:

{
  "name": "my-catalog-2",
  "owner": "someone@example.com",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "created_at": 1656355967835,
  "created_by": "someone@example.com",
  "updated_at": 1656356095989,
  "updated_by": "someone@example.com",
  "catalog_type": "MANAGED_CATALOG"
}

Wyświetlanie listy dostępnych wykazów

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog catalogs list --help.

databricks unity-catalog catalogs list

Wyjście:

{
  "catalogs": [
    {
      "name": "main",
      "owner": "someone@example.com",
      "comment": "Main catalog (auto-created)",
      "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656112029355,
      "created_by": "someone@example.com",
      "updated_at": 1656112029355,
      "updated_by": "someone@example.com",
      "catalog_type": "MANAGED_CATALOG"
    },
    {
      "...": "..."
    }
  ]
}

Uzyskiwanie informacji o wykazie

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog catalogs get --help.

databricks unity-catalog catalogs get --name my-catalog

Wyjście:

{
  "name": "my-catalog",
  "owner": "someone@example.com",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "created_at": 1656113178995,
  "created_by": "someone@example.com",
  "updated_at": 1656113178995,
  "updated_by": "someone@example.com",
  "catalog_type": "MANAGED_CATALOG"
}

Usuwanie wykazu

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog catalogs delete --help. Zobacz też Usuwanie wykazu.

Aby przymusowo usunąć wykaz, użyj --purge opcji .

databricks unity-catalog catalogs delete --name my-catalog

Jeśli operacja zakończy się pomyślnie, żadne wyniki nie zostaną zwrócone.

Schematy

unity-catalog schemas Użyj podpolecenia, aby pracować ze schematami.

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog schemas --help.

Tworzenie schematu

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog schemas create --help. Zobacz też Tworzenie schematów.

databricks unity-catalog schemas create --catalog-name my-catalog \
                                        --name my-schema

Wyjście:

{
  "name": "my-schema",
  "catalog_name": "my-catalog",
  "owner": "someone@example.com",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "full_name": "my-catalog.my-schema",
  "created_at": 1656113607800,
  "created_by": "someone@example.com",
  "updated_at": 1656113607800,
  "updated_by": "someone@example.com"
}

Zmienianie ustawień schematu

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog schemas update --help.

databricks unity-catalog schemas update --full-name my-catalog.my-schema \
                                        --json-file update-schema.json

update-schema.json:

{
  "name": "my-schema-2",
  "owner": "someone@example.com"
}

Wyjście:

{
  "name": "my-schema-2",
  "catalog_name": "my-catalog",
  "owner": "someone@example.com",
  "comment": "Default schema (auto-created)",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "full_name": "my-catalog.my-schema-2",
  "created_at": 1656355967837,
  "created_by": "someone@example.com",
  "updated_at": 1656356592786,
  "updated_by": "someone@example.com"
}

Lista dostępnych schematów

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog schemas list --help.

databricks unity-catalog schemas list --catalog-name my-catalog

Wyjście:

{
  "schemas": [
    {
      "name": "default",
      "catalog_name": "my-catalog",
      "owner": "someone@example.com",
      "comment": "Default schema (auto-created)",
      "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "full_name": "my-catalog.default",
      "created_at": 1656113178996,
      "created_by": "someone@example.com",
      "updated_at": 1656113178996,
      "updated_by": "someone@example.com"
    },
    {
      "...": "..."
    }
  ]
}

Uzyskiwanie informacji o schemacie

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog schemas get --help.

databricks unity-catalog schemas get --full-name my-catalog.my-schema

Wyjście:

{
  "name": "my-schema",
  "catalog_name": "my-catalog",
  "owner": "someone@example.com",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "full_name": "my-catalog.my-schema",
  "created_at": 1656113607800,
  "created_by": "someone@example.com",
  "updated_at": 1656113607800,
  "updated_by": "someone@example.com"
}

Usuwanie schematu

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog schemas delete --help. Zobacz też Usuwanie schematu.

Aby przymusowo usunąć schemat, użyj --purge opcji .

databricks unity-catalog schemas delete --full-name my-catalog.my-schema

Jeśli operacja zakończy się pomyślnie, żadne wyniki nie zostaną zwrócone.

Tabele

unity-catalog tables Użyj podpolecenia, aby pracować z tabelami.

Uwaga

Tworzenie tabel za pomocą interfejsu wiersza polecenia wykazu aparatu Unity nie jest obsługiwane. Aby utworzyć tabele, zobacz Co to są tabele i widoki? oraz Samouczek: tworzenie pierwszej tabeli i przyznawanie uprawnień.

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog tables --help.

Wyświetlanie listy dostępnych tabel

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog tables list --help.

databricks unity-catalog tables list --catalog-name main \
                                     --schema-name default

Wyświetlanie podsumowań dostępnych tabel

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog tables list-summaries --help.

databricks unity-catalog tables list-summaries --catalog-name main

Wyjście:

{
  "tables": [
    {
      "full_name": "main.default.mytable",
      "table_type": "MANAGED"
    },
    {
      "...": "..."
    }
  ]
}

Uzyskiwanie informacji o tabeli

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog tables get --help.

databricks unity-catalog tables get --full-name main.default.mytable

Usuń tabelę

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog tables delete --help.

databricks unity-catalog tables delete --full-name main.default.mytable

Jeśli operacja zakończy się pomyślnie, żadne wyniki nie zostaną zwrócone.

Linii

unity-catalog lineage Użyj podpolecenia, aby pracować z pochodzeniem tabel i kolumn.

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog lineage --help.

Wyświetlanie listy pochodzenia tabeli

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog lineage table --help.

databricks unity-catalog lineage table --table-name main.default.mytable \
                                       --level 1

Wyświetlanie listy pochodzenia kolumny

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog lineage column --help.

databricks unity-catalog lineage column --table-name main.default.mytable \
                                        --column-name id

Uprawnienia

Użyj polecenia podrzędnego unity-catalog permissions , aby pracować z uprawnieniami dla zabezpieczanych obiektów. Zobacz też Zarządzanie uprawnieniami w wykazie aparatu Unity.

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog permissions --help.

Uzyskiwanie informacji o uprawnieniach zabezpieczanego obiektu

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog permissions get --help. Zobacz również uprawnienia wykazu aparatu Unity i zabezpieczane obiekty.

Wykaz

databricks unity-catalog permissions get --catalog main

Wyjście:

{
  "privilege_assignments": [
    {
      "principal": "account users",
      "privileges": [
        "USE CATALOG"
      ]
    }
  ]
}

Schemat

databricks unity-catalog permissions get --schema main.default

Wyjście:

{
  "privilege_assignments": [
    {
      "principal": "account users",
      "privileges": [
        "USE SCHEMA"
      ]
    }
  ]
}

Table

databricks unity-catalog permissions get --table main.default.mytable

Wyjście:

{
  "privilege_assignments": [
    {
      "principal": "account users",
      "privileges": [
        "SELECT"
      ]
    }
  ]
}

Poświadczenia magazynu

databricks unity-catalog permissions get --storage-credential my-storage-root-credential

Wyjście:

{
  "privilege_assignments": [
    {
      "principal": "account users",
      "privileges": [
        "READ_FILES"
      ]
    }
  ]
}

Lokalizacja zewnętrzna

databricks unity-catalog permissions get --external-location my-external-location

Wyjście:

{
  "privilege_assignments": [
    {
      "principal": "account users",
      "privileges": [
        "READ_FILES"
      ]
    }
  ]
}

Aktualizowanie zabezpieczanych uprawnień obiektu

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog permissions update --help. Zobacz również uprawnienia wykazu aparatu Unity i zabezpieczane obiekty.

Wykaz

databricks unity-catalog permissions update --catalog \
                                            --json-file update-catalog-permissions.json

update-catalog-permissions.json:

{
  "changes": [
    {
      "principal": "account users",
      "add": [ "USE CATALOG" ],
      "remove": [ "CREATE SCHEMA" ]
    }
  ]
}

Schemat

databricks unity-catalog permissions update --schema \
                                            --json-file update-schema-permissions.json

update-schema-permissions.json:

{
  "changes": [
    {
      "principal": "account users",
      "add": [ "USE SCHEMA" ],
      "remove": [ "CREATE TABLE" ]
    },
    {
      "principal": "admin team",
      "add": [ "CREATE TABLE" ]
    }
  ]
}

Table

databricks unity-catalog permissions update --table \
                                            --json-file update-table-permissions.json

update-table-permissions.json:

{
  "changes": [
    {
      "principal": "account users",
      "add": [ "SELECT" ],
      "remove": [ "MODIFY" ]
    },
    {
      "principal": "admin team",
      "add": [ "ALL" ]
    }
  ]
}

Poświadczenia magazynu

databricks unity-catalog permissions update --storage-credential \
                                            --json-file update-storage-credential-permissions.json

update-storage-credential-permissions.json:

{
  "changes": [
    {
      "principal": "account users",
      "remove": [ "READ FILES" ]
    },
    {
      "principal": "storage team",
      "add": [ "READ FILES",
               "WRITE FILES",
               "CREATE EXTERNAL TABLE"
             ]
    },
    {
      "principal": "admin team",
      "add": [ "ALL" ]
    }
  ]
}

Lokalizacja zewnętrzna

databricks unity-catalog permissions update --external-location \
                                            --json-file update-external-location-permissions.json

update-external-location-permissions.json:

{
  "changes": [
    {
      "principal": "account users",
      "remove": [ "READ FILES" ]
    },
    {
      "principal": "storage team",
      "add": [ "READ FILES",
               "WRITE FILES",
               "CREATE EXTERNAL TABLE"
             ]
    },
    {
      "principal": "admin team",
      "add": [ "ALL" ]
    }
  ]
}

Udostępnienia

unity-catalog shares Użyj podpolecenia, aby pracować z udziałami, które są obiektami zawierającymi kolekcje tabel w magazynie metadanych wykazu aparatu Unity z włączoną funkcją Udostępniania różnicowego, który ma być udostępniany jako grupa adresatom udostępniania różnicowego. Udział może zawierać tabele tylko z jednego magazynu metadanych. Zobacz Tworzenie udziałów i zarządzanie nimi na potrzeby udostępniania różnicowego.

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog shares --help.

Tworzenie udziału

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog shares create --help. Zobacz również Tworzenie udziałów i zarządzanie nimi na potrzeby udostępniania różnicowego.

databricks unity-catalog shares create --name my-share

Wyjście:

{
  "name": "my-share",
  "created_at": 1656433327533,
  "created_by": "someone@example.com",
  "owner": "someone@example.com"
}

Aktualizowanie ustawień udziału

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog shares update --help. Zobacz też Aktualizowanie udziałów.

Dodawanie tabeli do udziału

databricks unity-catalog shares update --name my-share \
                                       --add-table main.default.mytable

Wyjście:

{
  "name": "my-share",
  "objects": [
    {
      "name": "main.default.mytable",
      "data_object_type": "TABLE",
      "added_at": 1656434168847,
      "added_by": "someone@example.com",
      "shared_as": "default.mytable",
      "cdf_enabled": false
    }
  ],
  "created_at": 1656433327533,
  "created_by": "someone@example.com",
  "owner": "someone@example.com"
}

Zobacz też Dodawanie tabel do udziału.

Usuwanie tabeli z udziału

databricks unity-catalog shares update --name my-share \
                                       --remove-table main.default.mytable

Wyjście:

{
  "name": "my-share",
  "created_at": 1656433327533,
  "created_by": "someone@example.com",
  "owner": "someone@example.com"
}

Zobacz też Dodawanie tabel do udziału.

Aktualizowanie uprawnień udziału

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog shares update-permissions --help. Zobacz też Zarządzanie dostępem do udziałów danych usługi Delta Sharing (dla dostawców).

databricks unity-catalog shares update-permissions --name my-share \
                                                   --json-file update-share-permissions.json

update-share-permissions.json:

{
  "privilege_assignments": [
    {
      "principal": "my-recipient",
      "privileges": [
        "SELECT"
      ]
    }
  ]
}

Wyświetlanie listy dostępnych udziałów

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog shares list --help. Zobacz też Wyświetlanie udziałów i udostępnianie szczegółów.

databricks unity-catalog shares list

Wyjście:

{
  "shares": [
    {
      "name": "my-share",
      "created_at": 1656433327533,
      "created_by": "someone@example.com",
      "owner": "someone@example.com"
    },
    {
      "...": "..."
    }
  ]
}

Uzyskiwanie informacji o udziale

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog shares get --help. Zobacz też Wyświetlanie udziałów i udostępnianie szczegółów.

databricks unity-catalog shares get --name my-share

Wyjście:

{
  "name": "my-share",
  "created_at": 1656433327533,
  "created_by": "someone@example.com",
  "owner": "someone@example.com"
}

Wyświetlanie listy uprawnień udziału

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog shares list-permissions --help. Zobacz również Wyświetlanie adresatów, którzy mają uprawnienia do udziału.

databricks unity-catalog shares list-permissions --name my-share

Wyjście:

{
  "privilege_assignments": [
    {
      "principal": "my-recipient",
      "privileges": [
        "SELECT"
      ]
    }
  ]
}

Usuwanie udziału

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog shares delete --help. Zobacz też Usuwanie udziału.

databricks unity-catalog shares delete --name my-share

Jeśli operacja zakończy się pomyślnie, żadne wyniki nie zostaną zwrócone.

Adresatów

unity-catalog recipients Użyj podpolecenia, aby pracować z adresatami danych na potrzeby magazynów metadanych wykazu aparatu Unity z włączoną obsługą udostępniania różnicowego. Adresaci danych to osoby lub grupy, którym użytkownik usługi Azure Databricks udostępnia dane poza organizacją użytkownika usługi Azure Databricks. Zobacz Tworzenie adresatów danych i zarządzanie nimi na potrzeby udostępniania różnicowego.

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog recipients --help.

Tworzenie adresata

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog recipients create --help. Zobacz również Tworzenie adresatów danych i zarządzanie nimi na potrzeby udostępniania różnicowego.

Aby wygenerować nowy adres URL aktywacji dla adresata, uruchom polecenie databricks unity-catalog recipients rotate-token. Aby zapoznać się z przykładem, zobacz Obracanie tokenu odbiorcy.

databricks unity-catalog recipients create --name my-recipient

Wyjście:

{
  "name": "my-recipient",
  "created_at": 1656435288003,
  "created_by": "someone@example.com",
  "tokens": [
    {
      "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656435288005,
      "created_by": "someone@example.com",
      "activation_url": "https://example.com/delta_sharing/retrieve_config.html?<unique-id>",
      "expiration_time": 1656521688006,
      "updated_at": 1656435288006,
      "updated_by": "someone@example.com"
    }
  ],
  "authentication_type": "TOKEN",
  "updated_at": 1656435288003,
  "updated_by": "someone@example.com",
  "owner": "someone@example.com"
}

Zmienianie ustawień adresata

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog recipients update --help.

databricks unity-catalog recipients update --name my-recipient \
                                           --json-file update-recipient-settings.json

update-recipient-settings.json:

{
  "name": "my-recipient-2"
}

Wyjście:

{
  "name": "my-recipient-2",
  "created_at": 1656435288003,
  "created_by": "someone@example.com",
  "tokens": [
    {
      "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656435288005,
      "created_by": "someone@example.com",
      "expiration_time": 1656436808507,
      "updated_at": 1656435908507,
      "updated_by": "someone@example.com"
    },
    {
      "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656435908509,
      "created_by": "someone@example.com",
      "activation_url": "https://example.com/delta_sharing/retrieve_config.html?<unique-id>",
      "expiration_time": 1656522308510,
      "updated_at": 1656435908510,
      "updated_by": "someone@example.com"
    }
  ],
  "authentication_type": "TOKEN",
  "updated_at": 1656436740986,
  "updated_by": "someone@example.com",
  "owner": "someone@example.com"
}

Obracanie tokenu odbiorcy

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog recipients rotate-token --help. Zobacz też Zarządzanie tokenami adresatów (otwieranie udostępniania).

databricks unity-catalog recipients rotate-token --name my-recipient \
                                                 --existing-token-expire-in-seconds 900

Wyjście:

{
  "name": "my-recipient",
  "created_at": 1656435288003,
  "created_by": "someone@example.com",
  "tokens": [
    {
      "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656435288005,
      "created_by": "someone@example.com",
      "expiration_time": 1656436808507,
      "updated_at": 1656435908507,
      "updated_by": "someone@example.com"
    },
    {
      "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656435908509,
      "created_by": "someone@example.com",
      "activation_url": "https://example.com/delta_sharing/retrieve_config.html?<unique-id>",
      "expiration_time": 1656522308510,
      "updated_at": 1656435908510,
      "updated_by": "someone@example.com"
    }
  ],
  "authentication_type": "TOKEN",
  "updated_at": 1656435288003,
  "updated_by": "someone@example.com",
  "owner": "someone@example.com"
}

Wyświetlanie listy dostępnych adresatów

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog recipients list --help. Zobacz też Wyświetlanie adresatów.

databricks unity-catalog recipients list

Wyjście:

{
  "recipients": [
    {
      "name": "my-recipient",
      "created_at": 1656435288003,
      "created_by": "someone@example.com",
      "tokens": [
        {
          "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
          "created_at": 1656435288005,
          "created_by": "someone@example.com",
          "activation_url": "https://example.com/delta_sharing/retrieve_config.html?<unique-id>",
          "expiration_time": 1656521688006,
          "updated_at": 1656435288006,
          "updated_by": "someone@example.com"
        }
      ],
      "authentication_type": "TOKEN",
      "updated_at": 1656435288003,
      "updated_by": "someone@example.com",
      "owner": "someone@example.com"
    }
  ]
}

Wyświetlanie listy uprawnień udziału adresata

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog recipients list-permissions --help. Zobacz również Wyświetlanie uprawnień udziału adresata.

databricks unity-catalog recipients list-permissions --name my-recipient

Wyjście:

{
  "permissions_out": [
    {
      "share_name": "my-share",
      "privilege_assignments": [
        {
          "privileges": [
            "SELECT"
          ]
        }
      ]
    }
  ]
}

Uzyskiwanie informacji o odbiorcy

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog recipients get --help. Zobacz również Wyświetlanie szczegółów adresata.

databricks unity-catalog recipients get --name my-recipient

Wyjście:

{
  "name": "my-recipient",
  "created_at": 1656435288003,
  "created_by": "someone@example.com",
  "tokens": [
    {
      "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656435288005,
      "created_by": "someone@example.com",
      "activation_url": "https://example.com/delta_sharing/retrieve_config.html?<unique-id>",
      "expiration_time": 1656521688006,
      "updated_at": 1656435288006,
      "updated_by": "someone@example.com"
    }
  ],
  "authentication_type": "TOKEN",
  "updated_at": 1656435288003,
  "updated_by": "someone@example.com",
  "owner": "someone@example.com"
}

Usuwanie adresata

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog recipients delete --help. Zobacz też Usuwanie adresata.

databricks unity-catalog recipients delete --name my-recipient

Jeśli operacja zakończy się pomyślnie, żadne wyniki nie zostaną zwrócone.

Dostawcy usługi

Jeśli jesteś adresatem udostępnionych danych usługi Delta Sharing, użyj unity-catalog providers podpolecenia, aby pracować z dostawcami danych usługi Delta Sharing. Zobacz Zarządzanie dostawcami udostępniania różnicowego (w przypadku adresatów danych).

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog providers --help.

Tworzenie dostawcy

Jeśli jesteś odbiorcą danych udostępnionych przy użyciu protokołu open sharing i używasz obszaru roboczego usługi Databricks dołączonego do magazynu metadanych wykazu aparatu Unity, możesz utworzyć obiekt dostawcy w magazynie metadanych wykazu aparatu Unity. Następnie możesz zarządzać dostępem do udostępnionych danych przy użyciu wykazu aparatu Unity.

Ważne

Ten scenariusz jest rzadki. Jeśli używasz obszaru roboczego usługi Databricks, który jest włączony dla wykazu aparatu Unity, a inny klient usługi Databricks udostępnia Ci dane, powinien używać funkcji Udostępniania usługi Databricks do usługi Databricks. Dzięki udostępnianiu usługi Databricks do usługi Databricks obiekty dostawcy są tworzone w wykazie aparatu Unity.

Aby utworzyć dostawcę, musisz:

  • Być administratorem magazynu metadanych lub użytkownikiem z CREATE_PROVIDER uprawnieniami do magazynu metadanych.
  • Mieć dostęp do pobranego pliku poświadczeń. Zobacz Uzyskiwanie dostępu w modelu otwierania udostępniania.

Uruchom następujące polecenie, zastępując my-provider ciąg nazwą, którą chcesz nadać dostawcy, i config.share ścieżką do pobranego pliku poświadczeń, który domyślnie nosi nazwę config.share.

databricks unity-catalog providers create --name my-provider  \
                  --recipient-profile-json-file config.share

Aktualizowanie ustawień dostawcy

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog providers update --help.

databricks unity-catalog providers update --name my-provider \
                                          --new-name my-provider-2

Wyświetlanie listy dostępnych dostawców

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog providers list --help.

databricks unity-catalog providers list

Uzyskiwanie informacji o dostawcy

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog providers get --help.

databricks unity-catalog providers get --name my-provider

Wyświetlanie listy dostępnych udziałów dostawcy

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog providers list-shares --help.

databricks unity-catalog providers list-shares --name my-provider

Usuń dostawcę

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog providers delete --help.

databricks unity-catalog providers delete --name my-provider

Jeśli operacja zakończy się pomyślnie, żadne wyniki nie zostaną zwrócone.