Dela via

Ansluta till din Azure Quantum-arbetsyta med Python-paketet azure-quantum

  • Artikel

När du har skapat en Azure Quantum-arbetsyta kan du ansluta till den och skicka din kod med hjälp av azure-quantum Python-paketet. Paketet azure-quantum innehåller en Workspace klass som representerar en Azure Quantum-arbetsyta.

Förutsättningar

Ansluta med hjälp av en anslutningssträng

Du kan använda en anslutningssträng för att ange anslutningsparametrarna till en Azure Quantum-arbetsyta. Du kan använda en anslutningssträng i följande scenarier:

  • Du vill dela åtkomsten till arbetsytan med andra som inte har något Azure-konto.
  • Du vill dela arbetsytans åtkomst med andra under en begränsad tid.
  • Du kan inte använda Microsoft Entra-ID på grund av företagsprinciper.

Dricks

Varje Azure Quantum-arbetsyta har primära och sekundära nycklar och deras motsvarande anslutningssträng. Om du vill tillåta åtkomst till din arbetsyta till andra kan du dela din sekundära nyckel och använda din primära för dina egna tjänster. På så sätt kan du ersätta den sekundära nyckeln efter behov utan avbrott i dina egna tjänster. Mer information om hur du delar åtkomst till arbetsytan finns i Dela åtkomst till arbetsytan.

Kopiera anslutningssträngen

  1. Logga in på Azure Portal och välj din Azure Quantum-arbetsyta.

  2. I den vänstra panelen går du till Åtkomstnycklar för åtgärder>.

  3. Åtkomstnycklar måste vara aktiverade. Om åtkomstnycklar är inaktiverade måste du aktivera dem först. Se hur du gör det i Hantera dina åtkomstnycklar.

  4. Klicka på ikonen Kopiera för att kopiera anslutningssträng. Du kan välja antingen den primära eller sekundära anslutningssträng.

    Skärmbild av Azure Portal som visar hur du kopierar anslutningssträng.

Varning

Att lagra dina kontoåtkomstnycklar eller anslutningssträng i klartext utgör en säkerhetsrisk och rekommenderas inte. Lagra dina kontonycklar i ett krypterat format eller migrera dina program för att använda Microsoft Entra-auktorisering för åtkomst till din Azure Quantum-arbetsyta.

Använd anslutningssträng för att komma åt din Azure Quantum-arbetsyta

När du har kopierat anslutningssträng kan du använda den för att ansluta till din Azure Quantum-arbetsyta.

Om du arbetar med en Python-miljö kan du skapa ett Workspace objekt för att ansluta till din Azure Quantum-arbetsyta. När du skapar ett Workspace objekt har du två alternativ för att identifiera din Azure Quantum-arbetsyta.

  • Du kan skapa ett Workspace objekt genom att anropa 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())

  • Om du inte vill kopiera anslutningssträng i koden kan du även lagra dina anslutningssträng i en miljövariabel och använda 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())

Mer information om hur du aktiverar/inaktiverar och återskapar dina nycklar finns i Hantera dina åtkomstnycklar.

Viktigt!

När åtkomstnycklar är inaktiverade, är alla begäranden som använder anslutningssträng eller åtkomstnycklar obehöriga. Du kan fortfarande använda arbetsyteparametrarna för att ansluta till din arbetsyta.

Ansluta med hjälp av arbetsyteparametrarna

Varje Azure Quantum-arbetsyta har en unik uppsättning parametrar som du kan använda för att ansluta till den. Du kan använda följande parametrar för att ansluta till din Azure Quantum-arbetsyta:

Parameter Description
subscription_id Prenumerations-ID för Azure.
resource_group Namnet på Azure-resursgruppen.
name Namnet på din Azure Quantum-arbetsyta.
location Den Azure-region där Azure Quantum-arbetsytan etableras. Detta kan anges som ett regionnamn, till exempel "USA, östra" eller ett platsnamn som "eastus".
resource_id Azure-resurs-ID för Azure Quantum-arbetsytan.

Du hittar arbetsyteparametrarna i översikten över din Azure Quantum-arbetsyta i Azure Portal.

  1. Logga in på ditt Azure-konto, https://portal.azure.com,

  2. Välj din Azure Quantum-arbetsyta och gå till Översikt.

  3. Kopiera parametrarna i fälten.

    Skärmbild av Visual Studio Code som visar hur du expanderar översiktsfönstret för din Kvantarbetsyta.

Använd arbetsyteparametrarna för att ansluta till din Azure Quantum-arbetsyta

Skapa ett Workspace objekt för att ansluta till din Azure Quantum-arbetsyta. När du skapar ett Workspace objekt har du två alternativ för att identifiera din Azure Quantum-arbetsyta.

  • Du kan ange plats och resurs-ID (rekommenderas):

    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")
    )

  • Du kan ange plats, prenumerations-ID, resursgrupp och arbetsytenamn:

    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")
    )

Relaterat innehåll