Udostępnij przez


Nawiązywanie połączenia z obszarem roboczym Azure Quantum przy użyciu modułu qdk.azure Python

Jeśli masz obszar roboczy usługi Azure Quantum, możesz nawiązać połączenie z obszarem roboczym i przesłać kod za pomocą modułu qdk.azure Języka Python. Moduł qdk.azure zawiera klasęWorkspace reprezentującą obszar roboczy usługi Azure Quantum.

Wymagania wstępne

Aby połączyć się z przestrzenią roboczą za pomocą modułu qdk.azure, musisz mieć:

Jeśli używasz interfejsu wiersza polecenia platformy Azure, musisz mieć najnowszą wersję. Aby uzyskać instrukcje dotyczące instalacji, zobacz:

Nawiązywanie połączenia za pomocą parametry połączenia

Możesz użyć ciągu połączenia, aby określić parametry połączenia z obszarem roboczym usługi 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ę w witrynie Azure Portal.
  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. Musisz włączyć 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 tych parametrów połączenia, które 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. Najlepszym rozwiązaniem jest przechowywanie kluczy kont w zaszyfrowanym formacie lub migrowanie aplikacji do korzystania z autoryzacji firmy Microsoft Entra 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.

Możesz użyć właśnie skopiowanych parametrów połączenia w celu nawiązania połączenia z obszarem roboczym usługi Azure Quantum za pomocą modułu qdk.azure lub programu Visual Studio Code (VS Code).

Utwórz Workspace obiekt, aby nawiązać połączenie z obszarem roboczym usługi Azure Quantum. Istnieją dwie opcje identyfikowania obszaru roboczego usługi Azure Quantum podczas tworzenia Workspace obiektu.

  • Wywołaj from_connection_string funkcję podczas tworzenia Workspace obiektu.

    # Create a new Workspace object from a connection string 
    from qdk.azure import Workspace 
    
    connection_string = "[Copy connection string]" 
    workspace = Workspace.from_connection_string(connection_string) 
    
    print(workspace.get_targets()) 
    
  • Jeśli nie chcesz kopiować parametrów połączenia w kodzie, zapisz parametry połączenia w zmiennej środowiskowej i użyj polecenia Workspace().

    # Use an environment variable to connect with your connection string
    
    connection_string = "[Copy connection string]" 
    
    import os 
    
    os.environ["AZURE_QUANTUM_CONNECTION_STRING"] = connection_string 
    
    from qdk.azure import Workspace 
    
    workspace = Workspace() 
    print(workspace.get_targets()) 
    

Aby uzyskać więcej informacji na temat włączania, wyłączania i ponownego generowania kluczy, 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. Nadal można jednak używać parametrów obszaru roboczego do nawiązywania połączenia z obszarem roboczym.

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. Aby nawiązać połączenie z obszarem roboczym platformy Azure, możesz użyć następujących parametrów:

Parametr Opis
subscription_id Identyfikator subskrypcji platformy Azure.
resource_group Nazwa grupy zasobów platformy Azure.
name Nazwa obszaru roboczego usługi Azure Quantum.
location Region świadczenia usługi Azure, w którym znajduje się obszar roboczy.
resource_id Identyfikator zasobu usługi Azure dla środowiska pracy Azure Quantum.

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

  1. Zaloguj się w witrynie Azure Portal.
  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

Upewnij się, że logujesz się do odpowiedniego klienta przed nawiązaniem połączenia z obszarem roboczym.

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

Parametry obszaru roboczego umożliwiają nawiązanie połączenia z obszarem roboczym usługi Azure Quantum za pomocą modułu qdk.azure lub interfejsu wiersza polecenia platformy Azure.

Utwórz Workspace obiekt, aby nawiązać połączenie z obszarem roboczym usługi Azure Quantum. Istnieją dwie opcje identyfikowania obszaru roboczego usługi Azure Quantum podczas tworzenia Workspace obiektu.

  • Określ identyfikator zasobu (zalecane):

    from qdk.azure import Workspace 
    
    workspace = Workspace(  
        resource_id = "", # Add the resource ID of your workspace
        location = "" # Add the location of your workspace
        )
    
  • Określ identyfikator subskrypcji, grupę zasobów i nazwę obszaru roboczego oraz lokalizację:

    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
        workspace_name = "" # Add the name of your workspace
        location = "" # Add the location of your workspace
        )