Udostępnij przez

Interfejs wiersza polecenia Unity Catalog (starsza wersja)

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. Databricks zaleca, aby użyć nowszego interfejsu wiersza polecenia 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 katalogu Unity jest eksperymentalny.

Interfejs wiersza polecenia Unity Catalog wymaga Legacy Databricks CLI w wersji 0.17.0 lub nowszej, skonfigurowanego z użyciem uwierzytelniania. 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 CLI Unity Catalog, aby pracować z:

  • Zasoby Unity Catalog, takie jak metasklepy, poświadczenia magazynowania, lokalizacje zewnętrzne, katalogi, schematy, tabele i ich uprawnienia.
  • Delta Sharing zasoby, takie jak udziały, adresaci i dostawcy.

Uruchamiasz podpolecenia CLI dla Unity Catalog, dołączając je do polecenia databricks unity-catalog. Te podpolecenia wywołują interfejs API Katalogu Unity, który obejmuje również interfejs API Delta Sharing.

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

Repozytoria metadanych

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

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

Utwórz magazyn metadanych

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog metastores create --help. Zobacz również Utwórz metamagazyn Katalogu Unity.

Uwaga

Utworzenie magazynu metadanych nie powoduje automatycznego skojarzenia go z obszarem roboczym ani z poświadczeniami 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 zobaczyć przykład, zobacz Podsumowane informacje o bieżącym magazynie metadanych.

Wyjście:

{}

Zobacz również Utwórz metamagazyn Katalogu 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 zobaczyć przykład, zobacz Podsumowane informacje o bieżącym magazynie metadanych.

update-metastore.json:

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

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

Wymień dostępne magazyny 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 zobaczyć przykład, zobacz Podsumowane informacje o bieżącym magazynie metadanych.

Uzyskaj podsumowane informacje o obecnym metastore

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

databricks unity-catalog metastores get-summary

Uzyskaj bieżące przypisanie 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 zobaczyć przykład, zobacz Podsumowane informacje o bieżącym magazynie metadanych.

Wyjście:

{}

Usuń magazyn 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 zobaczyć przykład, zobacz Podsumowane informacje o bieżącym magazynie metadanych.

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

Poświadczenia pamięci masowej

Użyj subpolecenia unity-catalog storage-credentials, aby zarządzać poświadczeniami dostępu do magazynu. Zobacz Utworzenie poświadczenia magazynowego, aby połączyć się z usługą Azure Data Lake Storage.

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

Utwórz poświadczenie 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.

Aktualizuj ustawienia poświadczeń magazynowych

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

Pokaż listę 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świadczeniu dostępu do 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 opcji --force.

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

Użyj podpolecenia unity-catalog external-locations, aby pracować z lokalizacjami zewnętrznymi. Zobacz Omówienie lokalizacji zewnętrznych.

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ż Omówienie lokalizacji zewnętrznych.

Zweryfikuj lokalizację zewnętrzną oraz parę poświadczeń

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

Zatwierdź nazwę lokalizacji zewnętrznej oraz parę 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

Użyj `unity-catalog catalogs` 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"
}

Wymień dostępne katalogi

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

Użyj podpolecenia unity-catalog schemas, aby pracować z 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

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

Uwaga

Tworzenie tabel przy użyciu Unity Catalog CLI nie jest obsługiwane. Aby utworzyć tabele, zobacz Tabele usługi Azure Databricks i 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.

Linie rodowe

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

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

Sporządź listę 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

Wylistuj pochodzenie 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 katalogu 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 katalogu Unity i obiekty możliwe do zabezpieczenia.

Katalog

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"]
    }
  ]
}

Stół

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

Wyjście:

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

Dane dostępowe

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 katalogu Unity i obiekty możliwe do zabezpieczenia.

Katalog

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"]
    }
  ]
}

Stół

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"]
    }
  ]
}

Dane dostępowe

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"]
    }
  ]
}

Akcje

Użyj podpolecenia unity-catalog shares, aby pracować z udziałami, które są obiektami zawierającymi kolekcje tabel w katalogu metastore Unity Catalog z funkcją Delta Sharing, które chcesz udostępnić grupowo odbiorcom Delta Sharing. Udział może zawierać tabele tylko z jednego magazynu metadanych. Zobacz Tworzenie udziałów i zarządzanie nimi dla Delta Sharing.

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 dla Delta Sharing.

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ń udostępniania

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ż Dodaj tabele do udostępniania.

Usuń tabelę 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ż Dodaj tabele do udostępniania.

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 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"
}

Wymień uprawnienia udziału

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks unity-catalog shares list-permissions --help. Zobacz również Zobacz odbiorcó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"]
    }
  ]
}

Usuń udział

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

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

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

Adresatów

Użyj podpolecenia unity-catalog recipients, aby pracować z odbiorcami danych dla metamagazynów Unity Catalog z włączoną funkcją Delta Sharing. 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 i zarządzanie odbiorcami danych dla Delta Sharing (udostępnianie Databricks-to-Databricks).

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 i zarządzanie odbiorcami danych dla Delta Sharing (udostępnianie Databricks-to-Databricks).

Aby wygenerować nowy adres URL aktywacji dla adresata, uruchom polecenie databricks unity-catalog recipients rotate-token. Aby zapoznać się z przykładem, zobacz Obróć token 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.

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"
}

Lista 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świetl listę uprawnień do zasobów 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ż Zobacz szczegóły 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 Delta Sharing (dla odbiorcó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 otwartego udostępniania i używasz obszaru roboczego Databricks z połączonym magazynem metadanych Unity Catalog, możesz utworzyć obiekt dostawcy w magazynie metadanych Unity Catalog. Następnie możesz zarządzać dostępem do udostępnionych danych, korzystając z Unity Catalog.

Ważne

Ten scenariusz jest rzadki. Jeśli używasz obszaru roboczego Databricks z włączonym Unity Catalogiem, a inny klient Databricks udostępnia ci dane, powinien korzystać z funkcji udostępniania Databricks-to-Databricks. Dzięki udostępnianiu Databricks do Databricks, obiekty dostawcy są tworzone w Unity Catalog.

Aby utworzyć dostawcę, musisz:

Uruchom następujące polecenie, zastępując my-provider 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.

  • Last updated on