Udostępnij za pomocą


Konfiguracja łączności programu PolyBase (Transact-SQL)

Dotyczy: Program SQL Server nie jest obsługiwany. Usługa Azure SQL Database nie jest obsługiwana. Azure Synapse Analytics Platform System (PDW)

Wyświetla lub zmienia globalne ustawienia konfiguracji dla łączności usług PolyBase Hadoop i Microsoft Azure Blob Storage.

Transact-SQL konwencje składni

Składnia

Wyświetl listę wszystkich opcji konfiguracji.

sp_configure
[ ; ]

Konfigurowanie łączności z usługą Hadoop.

sp_configure [ @configname = ] 'hadoop connectivity' ,
             [ @configvalue = ] { 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 }
[ ; ]

RECONFIGURE
[ ; ]

Arguments

[ @configname = ] 'option_name'

Nazwa opcji konfiguracji. option_name jest varchar(35), z wartością domyślną NULL. Jeśli nie zostanie określona, zostanie zwrócona pełna lista opcji.

[ @configvalue = ] 'value'

Nowe ustawienie konfiguracji. wartość jest int z wartością domyślną NULL. Maksymalna wartość zależy od pojedynczej opcji.

"łączność hadoop"

Określa typ źródła danych usługi Hadoop dla wszystkich połączeń z programu PolyBase do klastrów Hadoop lub usługi Azure Blob Storage. Aby uzyskać więcej informacji, zobacz CREATE EXTERNAL DATA SOURCE.

Poniższa lista zawiera ustawienia łączności usługi Hadoop i odpowiednie obsługiwane źródła danych usługi Hadoop. W danym momencie może obowiązywać tylko jedno ustawienie.

Opcje 1, 4, 7 i 8 umożliwiają tworzenie i używanie wielu typów zewnętrznych źródeł danych we wszystkich sesjach na serwerze.

  • Opcja 0. Wyłączanie łączności z usługą Hadoop

  • Opcja 1: Hortonworks HDP 1.3 w systemie Windows Server

  • Opcja 1: Azure Blob Storage (WASB[S])

  • Opcja 2: Hortonworks HDP 1.3 w systemie Linux

  • Opcja 3: Cloudera CDH 4.3 w systemie Linux

  • Opcja 4: Hortonworks HDP 2.0 w systemie Windows Server

  • Opcja 4. Azure Blob Storage (WASB[S])

  • Opcja 5: Hortonworks HDP 2.0 w systemie Linux

  • Opcja 6: Cloudera CDH 5.1, 5.2, 5.3, 5.4, 5.5, 5.9, 5.10, 5.11, 5.12 i 5.13 w systemie Linux

  • Opcja 7: Hortonworks HDP 2.1, 2.2, 2.3, 2.4, 2.5, 2.6, 3.0 w systemie Linux

  • Opcja 7: Hortonworks HDP 2.1, 2.2, 2.3, 2.4 w systemie Windows Server

  • Opcja 7. Azure Blob Storage (WASB[S])

  • Opcja 8: 1 Hortonworks HDP 3.1, Cloudera CDH 6.1, 6.2, 6.3, Azure Blob Storage (WASB[S]) i Azure Data Lake Storage Gen2 (ABFS[S])

1 Opcja 8 została wprowadzona z programem SQL Server 2019 (15.x) CU 11.

Domyślnie łączność z usługą Hadoop jest ustawiona na 0 (wyłączona). Po zainstalowaniu należy skonfigurować wartość łączności hadoop programu PolyBase, a następnie włączyć program PolyBase. Aby uzyskać więcej informacji, zobacz Instalowanie programu PolyBase w systemie Windows i Konfigurowanie programu PolyBase w celu uzyskania dostępu do danych zewnętrznych w usłudze Hadoop.

RECONFIGURE

Aktualizuje wartość przebiegu (run_value), aby odpowiadała wartości konfiguracji (config_value). Zobacz Zestawy wyników dla definicji elementów run_value i config_value. Nowa wartość konfiguracji ustawiona przez sp_configure nie stanie się skuteczna, dopóki wartość przebiegu nie zostanie ustawiona przez instrukcję RECONFIGURE . Następnie po uruchomieniu RECONFIGUREprogramu należy zatrzymać i ponownie uruchomić usługę PROGRAMU SQL Server.

Ważne

Podczas zatrzymywania usługi PROGRAMU SQL Server te dwie dodatkowe usługi również zostaną automatycznie zatrzymane: aparat PolyBase i usługa przenoszenia danych. Po ponownym uruchomieniu usługi aparatu programu SQL Server ręcznie uruchom te dwie usługi ponownie, ponieważ nie zostaną uruchomione automatycznie.

Zwracanie wartości kodu

0 (powodzenie) lub 1 (niepowodzenie).

Zestaw wyników

Po wykonaniu bez parametrów sp_configure zwraca zestaw wyników z pięcioma kolumnami.

Nazwa kolumny Typ danych Description
name nvarchar(35) Nazwa opcji konfiguracji.
minimum int Minimalna wartość opcji konfiguracji.
maximum int Maksymalna wartość opcji konfiguracji.
config_value int Wartość, która została ustawiona przy użyciu polecenia sp_configure.
run_value int Bieżąca wartość używana przez program PolyBase. Ta wartość jest ustawiana przez uruchomienie polecenia RECONFIGURE.

Wartości config_value i run_value są zwykle takie same, chyba że wartość jest w trakcie zmiany.
Ponowne uruchomienie może być wymagane, zanim ta wartość przebiegu będzie dokładna, jeśli ponowna konfiguracja jest w toku.

Uwagi

W programie SQL Server, po uruchomieniu RECONFIGUREpolecenia , aby wartość uruchomienia polecenia "łączność hadoop" obowiązywała, należy ponownie uruchomić program SQL Server.

W systemie platformy analizy (PDW), po uruchomieniu RECONFIGUREprogramu , aby wartość przebiegu "łączność hadoop" obowiązywała, należy ponownie uruchomić region Systemu platformy analitycznej (PDW).

W programie SQL Server 2022 (16.x) i nowszych wersjach platforma Hadoop nie jest już obsługiwana w programie PolyBase.

Ograniczenia

RECONFIGURE nie jest dozwolone w jawnej lub niejawnej transakcji.

Permissions

Wszyscy użytkownicy mogą wykonywać bez sp_configure parametrów ani parametru @configname .

Wymaga ALTER SETTINGS uprawnień na poziomie serwera lub członkostwa w stałej roli serwera sysadmin , aby zmienić wartość konfiguracji lub uruchomić polecenie RECONFIGURE.

Przykłady

A. Wyświetlanie listy wszystkich dostępnych ustawień konfiguracji

W poniższym przykładzie pokazano, jak wyświetlić listę wszystkich opcji konfiguracji.

EXECUTE sp_configure;

Wynik zwraca nazwę opcji, po której następuje minimalna i maksymalna wartość opcji. Jest config_value to wartość używana przez program PolyBase podczas ponownej konfiguracji. Jest run_value to wartość, która jest obecnie używana. Wartości config_value i run_value są zwykle takie same, chyba że wartość jest w trakcie zmiany.

B. Wyświetlanie listy ustawień konfiguracji dla jednej nazwy konfiguracji

EXECUTE sp_configure @configname = 'hadoop connectivity';

C. Ustawianie łączności z usługą Hadoop

W tym przykładzie program PolyBase ustawia opcję 7. Ta opcja umożliwia programowi PolyBase tworzenie i używanie tabel zewnętrznych w usługach Hortonworks HDP 2.1, 2.2 i 2.3 w systemach Linux i Windows Server oraz w usłudze Azure Blob Storage. Na przykład program SQL Server może mieć 30 tabel zewnętrznych, z których 7 odwołuje się do danych w systemie Linux Hortonworks HDP 2.1, 4 w systemie Hortonworks HDP 2.2 w systemie Linux, 7 w systemie Hortonworks HDP 2.3 w systemie Linux, a pozostałe 12 odwołujące się do usługi Azure Blob Storage.

Ten kod umożliwia skonfigurowanie tabel zewnętrznych w celu odwołowania się do danych w usługach Hortonworks HDP 2.1, 2.2 i 2.3 w systemie Linux oraz w usłudze Azure Blob Storage.

EXECUTE sp_configure
    @configname = 'hadoop connectivity',
    @configvalue = 7;
GO

RECONFIGURE;
GO