Conéctate a tu Azure Quantum área de trabajo con QDK o CLI de Azure

Si tiene un área de trabajo de Azure Quantum, puede usar el módulo qdk.azurePython para conectarse al área de trabajo y enviar el código para que se ejecute en Azure Quantum. El qdk.azure módulo proporciona una Workspace clase que representa un Azure Quantum área de trabajo.

Advertencia

A partir del 11 de enero de 2027, Azure Quantum requiere que los usuarios de un área de trabajo de Quantum tengan el rol Quantum Workspace Data Reader o Quantum Workspace Data Contributor para ver los resultados del trabajo. El rol Colaborador de datos del área de trabajo de Quantum será necesario para enviar trabajos. Para evitar interrupciones en Azure Quantum los flujos de trabajo, asigne estos roles a los usuarios adecuados antes de la fecha límite. Para obtener más información, consulte Asignación de roles de acceso a datos para los usuarios del área de trabajo.

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 Azure Quantum trabajo. Si no tiene un espacio de trabajo, consulte Crear un Azure Quantum espacio de trabajo.

  • La versión más reciente del paquete qdkPython con el extra azure.

    pip install --upgrade "qdk[azure]"
    

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

Conexión con una cuenta de Azure

Use una cuenta de Azure para conectarse al espacio de trabajo de Azure Quantum con la extensión Microsoft Quantum Development Kit (QDK) en Visual Studio Code (VS Code).

  1. Abra VS Code.
  2. Seleccione Ver>paleta de comandos.
  3. Entre y seleccione QDK: conectarse a un espacio de trabajo de Azure Quantum.
  4. Elija Azure cuenta.
  5. Cuando un mensaje de VS Code indica que QDK desea iniciar sesión, seleccione Permitir.
  6. Seleccione la cuenta que se va a usar.
  7. Seleccione un tenant y una suscripción.

Para ver el área de trabajo de Azure Quantum, seleccione el icono de Microsoft Quantum de la barra de actividades.

Captura de pantalla del icono de panel Microsoft Quantum en la barra de actividades de Visual Studio Code.

Conexión con una cadena de conexión

Nota:

Las cadenas de conexión son menos seguras que una cuenta de Azure.

Utilice una cadena de conexión para especificar los parámetros de conexión de un área de trabajo de Azure Quantum. Las cadenas de conexión son útiles cuando:

  • 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 se puede usar Microsoft Entra ID debido a las directivas de la empresa.

Sugerencia

Cada Azure Quantum área de trabajo tiene una clave principal y una clave secundaria, y cada clave tiene su propia cadena de conexión. Para permitir que otros usuarios usen el área de trabajo, comparta la clave secundaria y mantenga la clave principal para sus propios servicios. De este modo, puede reemplazar la clave secundaria sin provocar tiempo de inactividad en los 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 Azure Quantum área de trabajo.
  3. En el panel del área de trabajo, expanda la lista desplegable Operaciones y seleccione Claves de acceso.
  4. Si el control deslizante Teclas de acceso está establecido en Deshabilitado, establézcalo 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

Almacenar las claves de acceso de la cuenta o las cadenas de conexión en texto no cifrado es un riesgo de seguridad. Almacene las claves de la cuenta en un formato cifrado o migre las aplicaciones para que usen la autorización de Microsoft Entra para el área de trabajo de Azure Quantum.

Usa la cadena de conexión para acceder a tu Azure Quantum área de trabajo

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

Para conectarse al espacio de trabajo 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 = "<ConnectionString>" # Replace with 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 = "<ConnectionString>" # Replace with 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 Autenticarse en el área de trabajo mediante una clave de acceso.

Importante

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

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

Cada Azure Quantum área de trabajo tiene un conjunto único de parámetros que usas para conectarte al área de trabajo.

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

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

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

Nota:

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

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

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

az account set --subscription <subscriptionId>

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

Para conectarse al área de trabajo 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 podría producir un error si tiene varias áreas de trabajo con el mismo nombre en el mismo tenant.

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