Conexión al área de trabajo de Azure Quantum con el QDK o la CLI de Azure

Si tiene un área de trabajo de Azure Quantum, puede conectarse al área de trabajo y enviar el código con el qdk.azure módulo Python. El qdk.azure módulo proporciona una Workspace clase que representa un área de trabajo de Azure Quantum.

Requisitos previos

Para conectarse al área de trabajo con el qdk.azure módulo, necesita lo siguiente:

  • Una cuenta de Azure con una suscripción activa. Si no tiene una cuenta de Azure, regístrese gratuitamente y regístrese para obtener una suscripción de pago por uso.

  • Un área de trabajo de Azure Quantum. Si no tiene un área de trabajo, consulte Creación de un área de trabajo de Azure Quantum.

  • La versión más reciente del qdk paquete de Python con el azure adicional.

    pip install --upgrade "qdk[azure]"

Si usa CLI de Azure, actualice a la versión más reciente. Para obtener instrucciones de instalación, consulte:

Conexión con una cadena de conexión

Use un cadena de conexión para especificar los parámetros de conexión en un área de trabajo de Azure Quantum. Las cadenas de conexión son útiles en los escenarios siguientes:

  • Quiere compartir el acceso al área de trabajo con otros usuarios que no tengan una cuenta de Azure.
  • Quiere compartir el acceso al área de trabajo con otros usuarios durante un tiempo limitado.
  • No puede usar el identificador de Entra de Microsoft debido a las directivas de empresa.

Sugerencia

Cada área de trabajo de Azure Quantum tiene una clave principal y una clave secundaria, y cada clave tiene su propia cadena de conexión. Para permitir que otros usuarios accedan al área de trabajo, comparta la clave secundaria y use la clave principal solo para sus propios servicios. Puede reemplazar la clave secundaria sin provocar tiempo de inactividad en sus propios servicios. Para obtener más información sobre cómo compartir el acceso al área de trabajo, consulte Uso compartido del acceso al área de trabajo.

Copiar la cadena de conexión

  1. Inicie sesión en Azure Portal.
  2. Vaya al área de trabajo de Azure Quantum.
  3. En el panel del área de trabajo, expanda la lista desplegable Operaciones y seleccione Claves de acceso.
  4. Habilite las claves de acceso para el área de trabajo. Si el control deslizante Claves de acceso está establecido en Deshabilitado, establezca el control deslizante en Habilitado.
  5. Seleccione el icono Copiar del cadena de conexión que desea copiar. Puede elegir la cadena de conexión principal o secundaria.

Advertencia

Es un riesgo de seguridad almacenar las claves de acceso de la cuenta o las cadenas de conexión en texto no cifrado. Almacene las claves de cuenta en un formato cifrado o migre las aplicaciones para usar la autorización de Microsoft Entra para acceder al área de trabajo de Azure Quantum.

Uso de la cadena de conexión para acceder al espacio de trabajo de Azure Quantum

Use la cadena de conexión que copió para conectarse al área de trabajo de Azure Quantum con el módulo qdk.azure o la extensión QDK en Visual Studio Code.

Para conectarse al área de trabajo de Azure Quantum, elija uno de los métodos siguientes.

  • Use la from_connection_string función para crear un Workspace objeto .

    from qdk.azure import Workspace 

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

print(workspace.get_targets())

  • Almacene la cadena de conexión en una variable de entorno.

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

Para obtener más información sobre cómo trabajar con claves, consulte Administrar las claves de acceso.

Importante

Si deshabilita las claves de acceso para el área de trabajo, no puede usar cadenas de conexión para conectarse al área de trabajo. Use los parámetros del área de trabajo para conectarse en su lugar.

Conéctese a su área de trabajo usando parámetros del workspace

Cada área de trabajo de Azure Quantum tiene un conjunto único de parámetros que puede usar para conectarse al área de trabajo.

Parámetro Descripción Usa cuando te conectes con
subscription_id Id. de suscripción de Azure. CLI de Azure
resource_group El nombre del grupo de recursos de Azure. CLI de Azure
name Nombre del área de trabajo de Azure Quantum. CLI de Azure
resource_id Identificador de recurso de Azure del área de trabajo de Azure Quantum. Python

Para buscar los parámetros del área de trabajo, siga estos pasos:

  1. Inicie sesión en Azure Portal.
  2. Vaya al área de trabajo de Azure Quantum.
  3. En el panel del área de trabajo, elija Información general.
  4. Despliegue el desplegable Essentials.
  5. Copie los parámetros en sus campos correspondientes.

Nota:

Asegúrese de iniciar sesión en el inquilino correcto antes de conectarse al área de trabajo. Para más información sobre los inquilinos, consulte Administración de suscripciones de Azure con la CLI de Azure.

Uso de parámetros del área de trabajo para conectarse al área de trabajo de Azure Quantum

Para mantener la sesión iniciada al ejecutar los scripts de Python, abra un terminal y ejecute el siguiente comando CLI de Azure. Este comando establece la suscripción para el área de trabajo. Reemplace <subscriptionId> con el Id. de suscripción.

az account set --subscription <subscriptionId>

Puede usar los parámetros del área de trabajo para conectarse al área de trabajo de Azure Quantum a través del qdk.azure módulo o a través de CLI de Azure.

Para conectarse al área de trabajo de Azure Quantum, elija una de las siguientes opciones.

  • Especifique el identificador de recurso (recomendado):

    from qdk.azure import Workspace 

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

  • Especifique el identificador de suscripción, el grupo de recursos y el nombre del área de trabajo:

    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
    )

  • Especifique solo el nombre del área de trabajo. Esta opción puede producir un error cuando tiene varias áreas de trabajo que tienen el mismo nombre en el mismo inquilino.

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

Contenido relacionado

  • Last updated on