Azure Quantum sorunlarını giderme

Azure Quantum hizmetiyle çalışırken bu yaygın sorunlarla karşılaşabilirsiniz. Bunları nasıl çözebileceğinize bakın.

İşleri gönderme

Sorun: Eksik targets

İşinizi target çalıştırmak istediğiniz yer kullanılabilir target listede yoksa, büyük olasılıkla Visual Studio Code için öğesinin en son sürümüneQuantum Development Kit güncelleştirmeniz gerekir. Daha fazla bilgi için bkz . QDK'yi güncelleştirme.

Sorun: İşlem geçersiz bir 'Yetkisiz' durum kodu döndürüyor

Bu sorunu çözme adımları:

1. Azure portal (https://portal.azure.com) açın ve hesabınızın kimliğini doğrulayın.

2. Gezin'in altında Abonelikler'i ve ardından aboneliğinizi seçin.

3. Erişim denetimi (IAM) öğesini seçin.

4. Erişimi denetle'nin altında e-posta adresinizi arayın ve hesabı seçin.

5. Listede Sahip veya Katkıda Bulunan rolü görmemeniz gerekir.

6. Rol atamaları sekmesini seçin.

   Not

   Rol atamaları sekmesini görmüyorsanız portalı tam ekran olarak genişletmeniz veya ad> atamaları bölmenizi kapatmanız< gerekebilir.

7. Rol açılan listesini seçin, Sahip veya Katkıda Bulunan'ı seçin, ardından e-posta adresinizi girin ve hesabınızı seçin.

8. Kaydet’i seçin.

9. Artık hesap kümenizin Sahip veya Katkıda Bulunan rolüyle yapılandırıldığını görmeniz gerekir.

10. Azure Quantum çalışma alanınızı yeniden İçerik Oluşturucu ve ardından bu yeni Çalışma Alanına karşı bir iş gönderin.

Sorun: CLI aracılığıyla Q# programı göndermeye çalışırken "Program derlanamadı"

komutunu kullanarak az quantum submit komut isteminde bir iş göndermeye çalışırken aşağıdaki hata iletisiyle karşılaşabilirsiniz:

az quantum job submit ...
Failed to compile program.
Command ran in 21.181 seconds (init: 0.457, invoke: 20.724)

Bu hata, Q# programında derlemenin başarısız olmasına neden olan bir sorun olduğunda oluşur.

Sorun: Derleyici hatası "Yanlış geçit parametresi sayısı"

Yerel bir Jupyter Notebook veya komut satırı ortamından Quantinuum'a iş gönderirken ve eski QASM çevirisini (OPENQASM 2.0) kullanırken şu hatayla karşılaşabilirsiniz:

Job ID <jobId> failed or was cancelled with the message: 1000: Compile error: [<file, line>] Wrong number of gate parameters

Bu hata, birçok dilde yaygın olarak olduğu gibi ondalık ayırıcı olarak virgül "," veya nokta olmayan başka bir karakter kullanıldığında oluşur. Nokta olmayan ondalık ayırıcıları "." noktalarıyla değiştirin.

// replace this line:
rx(1,5707963267948966) q[0];

// with this:
rx(1.5707963267948966) q[0];

Not

Bu sorun Azure Quantum portalında barındırılan not defterlerinde değil, yalnızca yerel geliştirme ortamlarında oluşmaz.

Sorun: Derleyici hatası "geçerli derleme yapılandırması için kullanılamıyor"

VS Code'da bir Jupyter Notebook Q# kod hücresi çalıştırdığınızda şu hatayla karşılaşabilirsiniz:

<function name> not found. Found a matching item `<function name>' that is not available for the current compilation configuration

Bu hata, QIR target profilinin Temel olarak ayarlandığını ve söz konusu işlevin Sınırsıztarget profil gerektirdiğini gösterir. Profili Sınırsız olarak ayarlamak target için:

1. VS Code'da Q# programınızdayken alttaki durum çubuğunda Q#: QIR tabanı'nı seçin.
2. Üst durum çubuğunda görüntülenen seçeneklerden Q#: kısıtlanmamış'ı seçin.

Sorun: İşlem geçersiz bir 'Yasak' durum kodu döndürdü

İlk işinizi gönderdiğinizde bir 'yasak' hata kodu alabilirsiniz.

Bu sorun çalışma alanı oluşturma sırasında kaynaklanabilir: Azure Quantum, yeni çalışma alanını belirtilen depolama hesabına bağlayan rol atamasını tamamlayamaz. Bu durum için tipik bir senaryo, çalışma alanı oluşturma işlemi tamamlanmadan önce sekme veya web tarayıcısının kapatılmasıdır.

Aşağıdaki adımları izleyerek bu rol ataması sorunuyla karşılaşdığınızı doğrulayabilirsiniz:

• Azure Portal'da yeni kuantum çalışma alanınıza gidin
• Genel Bakış>Essentials>Depolama hesabı'nın altında depolama hesabı bağlantısında öğesini seçin
• Sol gezinti çubuğunda Erişim Denetimi (IAM) öğesini seçin
• Rol Atamaları’nı seçin
• Çalışma alanınızın Katkıda Bulunan olarak göründüğünü doğrulayın
• Çalışma alanı Katkıda Bulunan olarak görünmüyorsa şunlardan birini yapabilirsiniz:
  • Yeni bir çalışma alanı İçerik Oluşturucu ve web tarayıcısı sekmesini veya penceresini kapatmadan önce çalışma alanı oluşturma işleminin tamamlanmasını beklediğinden emin olun.
  • Depolama hesabının altına uygun rol atamasını ekleme
    • Access Control (IAM) > Rol atamaları ekleme
    • Rol > Katkıda Bulunanı
    • Kullanıcı, grup veya hizmet sorumlusuna > erişim atama
    • [Çalışma alanı adı] öğesini seçin >
    • Kaydet

Sorun: İş hata koduyla başarısız oluyor: QIRPreProcessingFailed

Rigetti sağlayıcısına bir iş gönderdiğinizde iş başarısız olur ve Azure portal İş yönetim konsolunda bildirilir:

Error code: QIRPreProcessingFailed
Error message: No match found for output recording set converter from outputrecordingset.v2.labeled to outputrecordingset.v1.nonlabeled

Bu hataya pyqir veya qiskit-qir'in önceki bir sürümüyle bağımlılık çakışması neden olabilir. Yerel makinenizde tüm pyqir, pyqir-*ve qiskit-qir sürümlerini kaldırın ve ardından [qiskit] parametresini kullanarak azure-quantum Python paketini yükleyin veya güncelleştirin:

pip install --upgrade azure-quantum[qiskit]

Sorun: Başarısız işler hakkında temel bilgileri alma

Bir işi bir donanıma targetgönderdikten sonra, işiniz başarısız olmadan önce birkaç saat, hatta bir veya iki gün kuyrukta kalabilir.

Hata hakkında daha fazla bilgi almak için:

• Çıktıyı get_results() veya döndürülen hata iletisini görüntülemek için job nesnesiyle yöntemini kullanın:

job.get_results()

• Azure Portal çalışma alanınızda İşlemler > İş Yönetimi'ni seçin ve ardından iş Adı'nı seçerek bir ayrıntı bölmesi açın.
• Azure Portal çalışma alanınızda İşletim > Sağlayıcıları'nın seçimini yapın. Makinenin kullanılabilirliğini target doğrulayın. Durumu Düşürülmüş olarak gönderilen targets işler normalden daha uzun kuyrukta kalabilir. Bazen işler işlenir, ancak bazen zaman aşımına uyabilir ve kullanılamaz hatası targetdöndürür.

Sorun: Çalışma alanıma program aracılığıyla bağlanırken kimlik doğrulamam istenmeye devam ediyor

Azure Quantum Python SDK'sını (örneğin Jupyter not defterleri içinde) kullanıyorsanız ve AzureQuantumProvider sınıfını kullanarak çalışma alanınıza bağlanıyorsanız, betiğinizi her çalıştırdığınızda Azure'da kimlik doğrulaması yapmak için bir açılır pencereyle karşılaşabilirsiniz.

Bunun nedeni, betiği her çalıştırdığınızda güvenlik belirtecinizin sıfırlanmasıdır.

Azure CLI'yi kullanarak bu az login sorunu çözebilirsiniz. Daha fazla bilgi için bkz. az login.

Sorun: Azure-quantum paketini güncelleştirdikten sonra bir işi izlerken "ModuleNotFoundError: qiskit.tools adlı modül yok" hatasını alıyorum

Qiskit 1.0 itibarıyla qiskit.tools işlev için job_monitor() gerekli olan modül kullanım dışı bırakılmıştır. İşleri izlemek için veya result işlevlerini kullanınwait_for_final_state().

job = MyTarget.run(circuit, shots=100)

# to wait until the job is complete
job.wait_for_final_state() 

# to return the results of the job
result = job.result()

Azure Quantum Kaynak Tahmin Aracı

Aşağıdaki yaygın senaryolar kaynak tahmin işlerinin tamamlanmasını engelleyebilir. Bunları nasıl çözeceğinizi öğrenin.

Sorun: Kuantum algoritması en az bir T durumu veya ölçümü içermelidir

Rastgele bir kuantum programını 2B mantıksal kubit dizisiyle eşlemeyi hesaba katmak için Kaynak Tahmin Aracı, Paralel Sentez Sıralı Pauli Hesaplaması'nın (PSSPC) ( bkz. arXiv:2211.07629, Ek D) girişprogramı üzerinde gerçekleştirildiğini varsayar. Bu yaklaşımda, tüm Clifford operasyonları tüm T kapılarından, dönüş kapılarından ve ölçüm işlemlerden geçirilerek klasik olarak verimli bir şekilde değerlendirilebilecek tek bir Clifford operasyonu bırakılır. Bu nedenle, T geçitlerinden veya dönüş kapılarından veya ölçüm işlemlerinden gelen T durumlarını içermeyen bir kuantum programı fiziksel kuantum bilgi işlem kaynağı gerektirmez.

Error message: Algorithm requires at least one T state or measurement to estimate resources

Sorun: Fiziksel T geçidi hata oranı çok yüksek

Mantıksal T durumu hata oranı, hata bütçesine ve kuantum programındaki T durumlarının sayısına bağlıdır. T fabrikaları , fiziksel T kapısı hata oranına sahip olan fiziksel T kapılarından gerekli mantıksal T durumu hata oranına sahip T durumları oluşturmak için kullanılır. Genellikle, fiziksel T geçidi hata oranı gerekli mantıksal T kapısı hata hızından çok daha yüksektir. Bazı senaryolarda, fiziksel T kapısı hata oranı, gerekli mantıksal T durumu hata oranına kıyasla çok daha yüksektir; böylece yeterli kalitede mantıksal T durumları üretebilecek T fabrikası bulunamaz.

Error message: No T factory can be found, because the required logical T state error rate is too low

Böyle bir senaryoda şunları yapabilirsiniz:

• Hata bütçesini (toplam veya T durumlarının bölümü) artırın.
• Kubit parametrelerindeki fiziksel T geçidi hata oranını azaltın.
• T geçitlerini, dönüş geçitlerini ve Toffoli geçitlerini azaltarak kuantum programındaki T durumlarının sayısını azaltın.

Sorun: Fiziksel T geçidi hata oranı çok düşük

Fiziksel T kapısı hata oranının gerekli mantıksal T durumu hata hızından daha düşük olduğu tersi bir senaryo da vardır. Bu gibi durumlarda, fiziksel T kapısı hata oranı zaten yeterli kalitede olduğundan T fabrikası gerekmez. Ancak bu, fiziksel T durumlarını kod uzaklığı 1'den algoritmanın kod mesafesine aktaran aktarım birimlerinin etkisinin dikkatli bir şekilde dikkate alınmasını gerektirir (bkz. arXiv:2211.07629, Ek C). Genel olarak, T fabrikalarının varlığında, transfer birimlerinin maliyeti göz ardı edilir.

Error message: No T factory can be found, because the required logical T state error rate is too high; transfer units are necessary to perform a resource estimation accurately. One possibility to circumvent this problem is to increase the physical T gate error rate of the qubit parameters.

Böyle bir senaryoda şunları yapabilirsiniz:

• Kubit parametrelerindeki fiziksel T geçidi hata oranını gerekli mantıksal T durumu hata oranına yükseltin.
• Hata bütçesini veya yalnızca T durumlarının bölümünü azaltın.

Sorun: Hata oranı 0 ile 1 arasında bir sayı olmalıdır

Hata oranları her zaman 0 ile 1 arasında olmalıdır. Ayrıca, hata düzeltmenin etkili olması için geçitler ve ölçümler için fiziksel hata oranı, hata düzeltme kodunun özelliklerine ve gerekli mantıksal hata oranına bağlı bir değerin altında olmalıdır.

Böyle bir senaryoda şunları yapabilirsiniz:

• Hata bütçesini (toplam veya mantıksal hataların bölümü) artırın.
• Kubit parametrelerindeki fiziksel hata oranlarını azaltın.

Sorun: Kısıtlamalar çalışma zamanı üst sınırı ve fiziksel kubit sayısı üst sınırı birbirini dışlar

Kaynak Tahmin Aracı aynı anda yalnızca birini maxDuration veya maxPhysicalQubits kısıtlamalarını kabul eder, ancak ikisini kabul etmemektedir. Tek bir iş için hem hem de maxDurationmaxPhysicalQubitskısıtlamaları sağlarsanız hata döndürür BothDurationAndPhysicalQubitsProvided .

Sorun: QIR tahmin sayısı kapsayıcısı çalıştırma: tanımlanmamış simge __quantum__rt__result_record_output

Bu hata, parametresini Falseolarak ayarlamadan qiskit_qir Python paketi aracılığıyla Qiskit bağlantı hatları için QIR oluşturulmasından record_output kaynaklanır.

Bu hatayı önlemek için aşağıdakilerden birini yapın:

• Qiskit bağlantı hatlarını Azure Quantum'a göndermek için azure_quantum Python paketini kullanın (önerilir).
• qiskit_qir Python paketini kullanırken bağlantı hattınızı göndermeden önce parametresini record_outputFalse olarak ayarladığınızdan emin olun.

Azure Quantum çalışma alanı oluşturma

Çalışma alanı oluşturmak için Azure portal kullandığınızda aşağıdaki sorunlar oluşabilir.

Sorun: Azure portal çalışma alanı oluşturma formuna erişemezsiniz; bunun yerine bir aboneliğe kaydolmanız istenir

Etkin bir aboneliğiniz olmadığından bu sorun oluşur.

Örneğin, Azure hizmetlerinde kullanmak üzere 200 ABD doları (USD) ücretsiz Azure Kredisi içeren 30 günlük ücretsiz azure aboneliğine kaydolabilirsiniz. Bu Azure kredilerinin Azure Quantum Kredileri ile aynı olmadığını ve kuantum donanım sağlayıcılarında kullanılmaya uygun olmadığını unutmayın. 30 günlük kayıt sonrasında veya 200 ABD doları ücretsiz Azure kredisini (hangisi önce gerçekleşirse) kullandıktan sonra Azure Quantum hizmetlerini kullanmaya devam etmek için kullandıkça öde aboneliğine yükseltmeniz gerekir. Etkin bir aboneliğiniz olduğunda, Azure portal çalışma alanı oluşturma formuna erişmenizi sağlar.

Aboneliklerinizin ve ilişkili rollerinizin listesini görmek için bkz. Aboneliklerinizi denetleme.

Sorun: Hızlı oluşturma seçeneği kullanılamıyor

Hızlı oluşturma seçeneğini kullanabilmek için seçtiğiniz aboneliğin Sahibi olmanız gerekir. Aboneliklerinizin ve ilişkili rollerinizin listesini görmek için bkz. Aboneliklerinizi denetleme. Abonelik Katkıda Bulunanıysanız, bir çalışma alanı oluşturmak için Gelişmiş oluşturma seçeneğini kullanabilirsiniz.

Sorun: Kaynak grubu veya depolama hesabı oluşturamazsınız veya seçemezsiniz

Bu sorun, abonelik, kaynak grubu veya depolama hesabı düzeyinde gerekli yetkilendirmeye sahip olmadığınız için oluşur. Gerekli erişim düzeyleri hakkında daha fazla bilgi için bkz. Çalışma alanı oluşturmak için rol gereksinimleri.

Sorun: İçerik Oluşturucu'yi seçtikten sonra "Dağıtım Doğrulaması Başarısız Oldu" hata iletisi görüntüleniyor

Bu hata iletisi "İstemcinin eylem gerçekleştirme yetkisi yok" gibi daha fazla ayrıntı içerebilir.

Bu sorun, abonelik, kaynak grubu veya depolama hesabı düzeyinde gerekli yetkilendirmeye sahip olmadığınız için oluşur. Gerekli erişim düzeyleri hakkında daha fazla bilgi için bkz. Çalışma alanı oluşturmak için rol gereksinimleri.

Erişim kısa süre önce verildiyse sayfayı yenilemeniz gerekebilir. Yeni rol atamalarının yığın genelinde önbelleğe alınmış izinler üzerinde etkili olması bazen bir saat kadar sürebilir.

Sorun: Sağlayıcılar sekmesinde belirli bir kuantum donanım sağlayıcısını görmüyorsunuz

Sağlayıcı, aboneliğinizin ayarlandığı faturalama bölgesini desteklemediğinden bu sorun oluşur. Örneğin aboneliğiniz İsrail'de ayarlandıysa Sağlayıcılar sekmesi Rigetti'yi kullanılabilir bir sağlayıcı olarak listelemez. Sağlayıcıların listesi ve bunların ülkeye/bölgeye göre kullanılabilirliği için bkz. Azure Quantum sağlayıcılarının genel kullanılabilirliği.

Sorun: Çalışma alanı oluşturma veya sağlayıcıları ekleme/kaldırma işlemi "ResourceDeploymentFailure" veya "ProviderDeploymentFailure" ile başarısız oluyor

Bu sorun, "ResourceDeploymentFailure - 'AzureAsyncOperationWaiting' kaynak işlemi terminal sağlama durumu 'Failed' ile tamamlandı" veya "ProviderDeploymentFailure - Sağlayıcı için plan oluşturulamadı: <Sağlayıcının> adı" gibi daha fazla ayrıntı içerebilir.

Bunun nedeni kiracının Azure Market satın almaları etkinleştirmemesidir. Azure Market satın almaları etkinleştirmek için Azure Market satın almaları etkinleştirme bölümündeki adımları izleyin.

Azure Quantum portalı

Sorun: Kaydedilen not defterleri yüklenemiyor

Çalışma alanınızda Not Defterleri'ni seçtikten sonra, kaydedilen not defterlerinizin listesi bir ilerleme çubuğu görüntüler ancak hiçbir zaman yüklenmez.

Bunun iki nedeni olabilir:

1. Depolama hesabı artık yoksa. Çalışma alanına bağlı depolama hesabı silindiyse bu durum oluşabilir. Doğrulamak için çalışma alanının Genel Bakış sayfasını seçin ve depolama hesabının bağlantısını seçin. Depolama hesabı silinmişse 404 - Bulunamadı hatası görürsünüz.

2. Çalışma alanının yönetilen kimliği depolama hesabına katkıda bulunan değilse. Çalışma alanı kimliğinin (çalışma alanıyla aynı adı kullanan) depolama hesabına katkıda bulunan rol atamasına sahip olup olmadığını denetleyin. Doğrulamak için çalışma alanının Genel Bakış sayfasını seçin ve depolama hesabının bağlantısını seçin. Depolama hesabının Genel Bakış sayfasında Erişim denetimi (IAM) öğesini seçin ve çalışma alanının Katkıda Bulunan altında listelendiğini doğrulayın.