Nawiązywanie połączenia z obszarem roboczym usługi Azure Quantum przy użyciu pakietu azure-quantum python

Po utworzeniu obszaru roboczego usługi Azure Quantum możesz nawiązać z nim połączenie i przesłać kod przy użyciu azure-quantum pakietu języka Python. Pakiet azure-quantum udostępnia klasę Workspace reprezentującą obszar roboczy usługi Azure Quantum.

Wymagania wstępne

• Konto platformy Azure z aktywną subskrypcją. Jeśli nie masz konta platformy Azure, zarejestruj się bezpłatnie i zarejestruj się w celu korzystania z subskrypcji z płatnością zgodnie z rzeczywistym użyciem.

• Obszar roboczy usługi Azure Quantum. Zobacz Tworzenie obszaru roboczego usługi Azure Quantum.

• Najnowsza wersja pakietu Azure Quantum azure-quantum .

  !pip install --upgrade azure-quantum
  

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

  • Instalowanie interfejsu wiersza polecenia platformy Azure w systemie Windows
  • Instalowanie interfejsu wiersza polecenia platformy Azure w systemie Linux
  • Instalowanie interfejsu wiersza polecenia platformy Azure w systemie macOS

Nawiązywanie połączenia przy użyciu parametry połączenia

Możesz użyć parametry połączenia, aby określić parametry połączenia z obszarem roboczym usługi Azure Quantum. W następujących scenariuszach można użyć parametry połączenia:

• 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żyć identyfikatora Entra firmy Microsoft ze względu na zasady firmy.

Napiwek

Każdy obszar roboczy usługi Azure Quantum ma klucze podstawowe i pomocnicze oraz odpowiednie parametry połączenia. Jeśli chcesz zezwolić na dostęp do obszaru roboczego innym osobom, możesz udostępnić klucz pomocniczy i użyć podstawowego dla własnych usług. Dzięki temu możesz zastąpić klucz pomocniczy w razie potrzeby bez przestoju 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 witryny Azure Portal i wybierz swój obszar roboczy usługi Azure Quantum.

2. Na panelu po lewej stronie przejdź do pozycji Klucze dostępu do operacji>.

3. Klucze dostępu muszą być włączone. Jeśli klucze dostępu są wyłączone, musisz najpierw je włączyć. Zobacz, jak to zrobić w temacie Zarządzanie kluczami dostępu.

4. Kliknij ikonę Kopiuj, aby skopiować parametry połączenia. Możesz wybrać parametry połączenia podstawową lub pomocniczą.

   

Ostrzeżenie

Przechowywanie kluczy dostępu do konta lub parametry połączenia w postaci zwykłego tekstu stanowi zagrożenie bezpieczeństwa i nie jest zalecane. 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.

Uzyskiwanie dostępu do obszaru roboczego usługi Azure Quantum przy użyciu parametry połączenia

Po skopiowaniu parametry połączenia możesz użyć go do nawiązania połączenia z obszarem roboczym usługi Azure Quantum.

Python

Jeśli pracujesz ze środowiskiem języka Python, możesz utworzyć Workspace obiekt w celu nawiązania połączenia z obszarem roboczym usługi Azure Quantum. Podczas tworzenia Workspace obiektu dostępne są dwie opcje identyfikowania obszaru roboczego usługi Azure Quantum.

• Obiekt można utworzyć, Workspace wywołując funkcję from_connection_string.

  # Creating a new Workspace object from a connection string 
  from azure.quantum import Workspace 
  
  connection_string = "[Copy connection string]" 
  workspace = Workspace.from_connection_string(connection_string) 
  
  print(workspace.get_targets()) 
  

• Jeśli nie chcesz kopiować parametry połączenia w kodzie, możesz również przechowywać parametry połączenia w zmiennej środowiskowej i użyć polecenia Workspace().

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

VS Code

1. Otwórz Visual Studio Code.

2. Wybierz pozycję Widok —> Paleta poleceń i wpiszQ# : Połącz się z obszarem roboczym usługi Azure Quantum. Naciśnij klawisz Enter.

3. Wybierz pozycję Parametry połączenia.

4. Wklej parametry połączenia skopiowane z witryny Azure Portal i naciśnij Enter.

5. Obszar roboczy usługi Azure Quantum zostanie wyświetlony w okienku Eksplorator w obszarze Obszary robocze kwantowe. Obszar roboczy można rozwinąć, aby wyświetlić elementy docelowe dostępne w obszarze roboczym i listę zadań.

   

Aby uzyskać więcej informacji na temat włączania/wyłączania i ponownego generowania kluczy, zobacz Zarządzanie kluczami dostępu.

Ważne

Gdy klucze dostępu są wyłączone, wszystkie żądania korzystające z parametry połączenia lub kluczy dostępu są nieautoryzowane. Nadal możesz użyć parametrów obszaru roboczego, aby nawiązać połączenie z obszarem roboczym.

Nawiązywanie połączenia 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 z nim połączenia. Aby nawiązać połączenie z obszarem roboczym usługi Azure Quantum, 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 jest aprowizowany obszar roboczy usługi Azure Quantum. Można to określić jako nazwę regionu, taką jak "Wschodnie stany USA" lub nazwę lokalizacji, taką jak "eastus".
resource_id	Identyfikator zasobu platformy Azure obszaru roboczego usługi Azure Quantum.

Parametry obszaru roboczego można znaleźć w omówieniu obszaru roboczego usługi Azure Quantum w witrynie Azure Portal.

1. Zaloguj się do konta platformy Azure, https://portal.azure.com,

2. Wybierz obszar roboczy usługi Azure Quantum i przejdź do obszaru Przegląd.

3. Skopiuj parametry w polach.

   

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

Python

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

• Możesz określić lokalizację i identyfikator zasobu (zalecane):

  from azure.quantum import Workspace 
  
  workspace = Workspace(  
      resource_id = "", # Add the resource ID of your workspace
      location = "" # Add the location of your workspace (for example "westus")
      )
  

• Możesz określić lokalizację, identyfikator subskrypcji, grupę zasobów i nazwę obszaru roboczego:

  from azure.quantum 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 (for example "westus")
      )
  

Interfejs wiersza polecenia platformy Azure

Aby nawiązać połączenie z obszarem roboczym, możesz użyć interfejsu wiersza polecenia platformy Azure (interfejsu wiersza polecenia platformy Azure). Aby uzyskać więcej informacji, zobacz Zarządzanie obszarami roboczymi kwantowymi przy użyciu interfejsu wiersza polecenia platformy Azure.

1. Zaloguj się do konta platformy Azure przy użyciu interfejsu wiersza polecenia platformy Azure.

   az login
   

2. Wybierz subskrypcję, której chcesz użyć. Zastąp SubscriptionName ciąg nazwą subskrypcji. Możesz również użyć identyfikatora subskrypcji zamiast nazwy subskrypcji.

   az account set --subscription SubscriptionName
   

3. Ustaw obszar roboczy, którego chcesz użyć. Zastąp WorkspaceLocationwartości , ResourceGroupNamei WorkspaceName odpowiednio lokalizacją obszaru roboczego, nazwą grupy zasobów i nazwą obszaru roboczego.

   az quantum workspace set --location WorkspaceLocation --resource-group ResourceGroupName --workspace-name WorkspaceName
   

Powiązana zawartość

• Zarządzanie obszarami roboczymi kwantowymi przy użyciu interfejsu wiersza polecenia platformy Azure
• Udostępnianie dostępu do obszaru roboczego usługi Azure Quantum
• Zarządzanie obszarami roboczymi kwantowymi za pomocą usługi Azure Resource Manager
• Uwierzytelnianie przy użyciu jednostki usługi
• Uwierzytelnianie przy użyciu tożsamości zarządzanej