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 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ą 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 Tworzenie poświadczenia magazynu umożliwiającego dostęp do usługi ADLS Gen2.

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ż Utwórz poświadczenie magazynu umożliwiające dostęp do usługi ADLS Gen2.

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 Azure Databricks i Tutorial: Tworzenie pierwszej tabeli i udzielanie 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ż odniesienie do przywilejów w katalogu Unity.

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ż odniesienie do przywilejów w katalogu Unity.

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 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 też Tworzenie udziałów 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 Azure Databricks udostępnia dane poza organizacją użytkownika Azure Databricks. Zobacz Tworzenie odbiorców danych dla Delta Sharing (udostępnianie Databricks do 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 odbiorców danych na potrzeby usługi Delta Sharing (udostępnianie między obszarami roboczymi 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