Nawiązywanie połączenia z obszarem roboczym usługi Azure Quantum przy użyciu zestawu QDK lub interfejsu wiersza polecenia platformy Azure

Jeśli masz obszar roboczy Azure Quantum, możesz połączyć się z obszarem roboczym i przesłać kod przy użyciu modułu qdk.azure Python. Moduł qdk.azure zawiera klasęWorkspace reprezentującą obszar roboczy usługi Azure Quantum.

Ostrzeżenie

Od 11 stycznia 2027 r. usługa Azure Quantum będzie wymagać, aby użytkownicy obszaru roboczego Quantum mieli rolę Czytelnik danych obszaru roboczego Quantum lub Współautor danych obszaru roboczego Quantum, aby uzyskać dostęp do wyników zadań. Do przesyłania zadań wymagana jest rola Współautor danych obszaru roboczego Quantum. Aby uniknąć zakłóceń w przepływach pracy usługi Azure Quantum, przypisz te role odpowiednim użytkownikom przed wyznaczonym terminem. Aby uzyskać więcej informacji, zobacz Przypisywanie ról dostępu do danych dla użytkowników w obszarze roboczym.

Wymagania wstępne

Aby nawiązać połączenie z obszarem roboczym za pomocą modułu qdk.azure , potrzebne są następujące elementy:

  • Konto platformy Azure z aktywną subskrypcją. Jeśli nie masz konta platformy Azure, zarejestruj się bezpłatnie i wybierz subskrypcję typu "płać za użycie".

  • Obszar roboczy usługi Azure Quantum. Jeśli nie masz obszaru roboczego, zobacz Tworzenie obszaru roboczego usługi Azure Quantum.

  • Najnowsza wersja pakietu qdk Python z dodatkiem azure.

    pip install --upgrade "qdk[azure]"

Jeśli używasz Azure CLI, zaktualizuj do najnowszej wersji. Aby uzyskać instrukcje dotyczące instalacji, zobacz:

Nawiązywanie połączenia przy użyciu konta Azure

Użyj konta Azure, aby połączyć się z obszarem roboczym Azure Quantum za pomocą rozszerzenia QDK w programie Visual Studio Code.

  1. Otwórz program VS Code.
  2. Otwórz menu Widok i wybierz pozycję Paleta poleceń.
  3. Wprowadź i wybierz opcję QDK: Połącz się z obszarem roboczym usługi Azure Quantum.
  4. Wybierz konto platformy Azure.
  5. W programie VS Code pojawi się komunikat informujący, że QDK chce się zalogować; naciśnij przycisk Zezwól.
  6. Wybierz konto do użycia.
  7. Wybierz dzierżawcę.
  8. Wybierz subskrypcję.

Aby wyświetlić obszar roboczy Azure Quantum, wybierz ikonę panelu Microsoft Quantum (w lewym dolnym rogu).

Zrzut ekranu przedstawiający ikonę panelu Microsoft Quantum.

Nawiązywanie połączenia za pomocą ciągu połączenia

Uwaga / Notatka

Nawiązywanie połączenia przy użyciu parametrów połączenia jest mniej bezpieczne niż użycie konta Azure.

Użyj parametry połączenia, aby określić parametry połączenia z obszarem roboczym Azure Quantum. Parametry połączenia są przydatne w następujących scenariuszach:

  • Chcesz udostępnić dostęp do obszaru roboczego innym osobom, które nie mają konta platformy Azure.
  • Chcesz udostępnić dostęp do obszaru roboczego innym osobom przez ograniczony czas.
  • Nie można używać identyfikatora Entra firmy Microsoft z powodu zasad firmy.

Napiwek

Każdy obszar roboczy usługi Azure Quantum ma klucz podstawowy i klucz pomocniczy, a każdy klucz ma własne parametry połączenia. Aby umożliwić innym osobom dostęp do obszaru roboczego, udostępnij klucz pomocniczy i użyj klucza podstawowego tylko dla własnych usług. Możesz zastąpić klucz pomocniczy bez powodowania przestojów we własnych usługach. Aby uzyskać więcej informacji na temat udostępniania dostępu do obszaru roboczego, zobacz Udostępnianie dostępu do obszaru roboczego.

Kopiowanie parametrów połączenia

  1. Zaloguj się do portalu Azure.
  2. Przejdź do obszaru roboczego usługi Azure Quantum.
  3. W panelu obszaru roboczego rozwiń listę rozwijaną Operacje i wybierz pozycję Klucze dostępu.
  4. Włącz klucze dostępu dla obszaru roboczego. Jeśli suwak Klucze dostępu jest ustawiony na Wyłączone, ustaw suwak na Włączone.
  5. Wybierz ikonę Kopiuj dla parametry połączenia, którą chcesz skopiować. Możesz wybrać podstawowe lub pomocnicze parametry połączenia.

Ostrzeżenie

Przechowywanie kluczy dostępu do konta lub ciągów połączeń w postaci zwykłego tekstu stanowi zagrożenie bezpieczeństwa. Zapisz klucze konta w zaszyfrowanym formacie lub przeprowadź migrację aplikacji, aby używać autoryzacji firmy Microsoft w celu uzyskania dostępu do obszaru roboczego usługi Azure Quantum.

Użyj ciągu połączenia, aby uzyskać dostęp do obszaru roboczego usługi Azure Quantum.

Użyj skopiowanych parametrów połączenia, aby połączyć się z obszarem roboczym Azure Quantum za pomocą modułu qdk.azure lub rozszerzenia QDK w programie Visual Studio Code.

Aby nawiązać połączenie z obszarem roboczym Azure Quantum, wybierz jedną z następujących metod.

  • Użyj funkcji from_connection_string, aby utworzyć obiekt Workspace.

    from qdk.azure import Workspace 

connection_string = "" # Add your connection string
workspace = Workspace.from_connection_string(connection_string) 

print(workspace.get_targets())

  • Zapisz parametry połączenia w zmiennej środowiskowej.

    import os
from qdk.azure import Workspace 

connection_string = "" # Add your connection string  
os.environ["AZURE_QUANTUM_CONNECTION_STRING"] = connection_string 

workspace = Workspace() 
print(workspace.get_targets())

Aby uzyskać więcej informacji o sposobie pracy z kluczami, zobacz Zarządzanie kluczami dostępu.

Ważne

Jeśli wyłączysz klucze dostępu dla obszaru roboczego, nie możesz używać parametrów połączenia do nawiązywania połączenia z obszarem roboczym. Zamiast tego użyj parametrów obszaru roboczego, aby się połączyć.

Nawiązywanie połączenia z obszarem roboczym przy użyciu parametrów obszaru roboczego

Każdy obszar roboczy usługi Azure Quantum ma unikatowy zestaw parametrów, których można użyć do nawiązania połączenia z obszarem roboczym.

Parametr Opis Używanie podczas nawiązywania połączenia z usługą
subscription_id Identyfikator subskrypcji platformy Azure. Azure CLI
resource_group Nazwa grupy zasobów platformy Azure. Azure CLI
name Nazwa obszaru roboczego usługi Azure Quantum. Azure CLI
resource_id Identyfikator zasobu usługi Azure dla środowiska pracy Azure Quantum. Python

Aby znaleźć parametry obszaru roboczego, wykonaj następujące kroki:

  1. Zaloguj się do portalu Azure.
  2. Przejdź do obszaru roboczego usługi Azure Quantum.
  3. W panelu obszaru roboczego wybierz pozycję Przegląd.
  4. Rozwiń listę rozwijaną Podstawy .
  5. Skopiuj parametry w odpowiednich polach.

Uwaga / Notatka

Przed połączeniem z obszarem roboczym upewnij się, że zalogujesz się do właściwego tenantu. Aby uzyskać więcej informacji na temat dzierżaw, zobacz Jak zarządzać subskrypcjami platformy Azure za pomocą interfejsu wiersza polecenia platformy Azure.

Nawiązywanie połączenia z obszarem roboczym usługi Azure Quantum przy użyciu parametrów obszaru roboczego

Aby pozostać zalogowanym podczas uruchamiania skryptów Python, otwórz terminal i uruchom następujące polecenie Azure CLI. To polecenie ustawia subskrypcję dla Twojego obszaru roboczego. Zastąp <subscriptionId> identyfikatorem subskrypcji.

az account set --subscription <subscriptionId>

Parametry obszaru roboczego umożliwiają nawiązywanie połączenia z obszarem roboczym Azure Quantum za pośrednictwem modułu qdk.azure lub za pośrednictwem Azure CLI.

Aby nawiązać połączenie z obszarem roboczym Azure Quantum, wybierz jedną z następujących opcji.

  • Określ identyfikator zasobu (zalecane):

    from qdk.azure import Workspace 

workspace = Workspace(resource_id="") # Add the resource ID of your workspace

  • Określ identyfikator subskrypcji, grupę zasobów i nazwę obszaru roboczego:

    from qdk.azure import Workspace 

workspace = Workspace(  
    subscription_id="", # Add the subscription ID of your workspace
    resource_group="", # Add the resource group of your workspace
    name="" # Add the name of your workspace
    )

  • Określ tylko nazwę obszaru roboczego. Ta opcja może zakończyć się niepowodzeniem, jeśli masz wiele obszarów roboczych o tej samej nazwie w tej samej dzierżawie.

    from qdk.azure import Workspace 
workspace = Workspace(name="") # Add the name of your workspace

Powiązana zawartość

  • Last updated on