Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Bu makalede Jupyter not defterlerinizi Azure Machine Learning stüdyosu çalışma alanınızda çalıştırma işlemi gösterilmektedir. Not defterlerini Jupyter, JupyterLab ve Visual Studio Code kullanarak da çalıştırabilirsiniz. VS Code Desktop, işlem örneğinize erişmek için yapılandırılabilir. Veya doğrudan tarayıcıdan ve gerekli yüklemeler veya bağımlılıklar olmadan Web için VS Code kullanabilirsiniz.
İpucu
Sağladığı kolay tümleştirme ve zengin geliştirme ortamından yararlanmak için Web için VS Code'ı denemenizi öneririz. Web için VS Code, gözatma ve düzenleme sırasında arama ve söz dizimi vurgulama da dahil olmak üzere sevdiğiniz VS Code Desktop'ın birçok özelliğini sunar. VS Code Desktop ve Web için VS Code'u kullanma hakkında daha fazla bilgi için bkz. Azure Machine Learning ile tümleşik Visual Studio Code'u başlatma ve bir işlem örneğine uzaktan bağlı olarak VS Code'da çalışma.
Not defterini çalıştırmak için hangi çözümü kullanırsanız kullanın, çalışma alanınızdaki tüm dosyalara erişebilirsiniz. Not defterleri dahil olmak üzere dosyaları oluşturma ve yönetme hakkında bilgi için bkz . Çalışma alanınızda dosya oluşturma ve yönetme.
Bu makalede, not defterini doğrudan Studio'da çalıştırma deneyimi gösterilmektedir.
Önemli
(önizleme) olarak işaretlenmiş özellikler hizmet düzeyi sözleşmesi olmadan sağlanır ve üretim iş yükleri için önerilmez. Bazı özellikler desteklenmiyor olabileceği gibi özellikleri sınırlandırılmış da olabilir. Daha fazla bilgi için bkz. Microsoft Azure Önizlemeleri Ek Kullanım Koşulları.
Önkoşullar
- Azure aboneliği. Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.
- Machine Learning çalışma alanı. Bkz. Çalışma alanı kaynakları oluşturma.
- Kullanıcı kimliğinizin çalışma alanınızın varsayılan depolama hesabına erişimi olmalıdır. Not defterlerini okuyup okuyamayacağınız, düzenleyebilmeniz veya oluşturabilmeniz, çalışma alanınıza erişim düzeyinize bağlıdır. Örneğin, Katkıda Bulunan not defterini düzenleyebilirken Okuyucu yalnızca onu görüntüleyebilir.
- Notebook hücrelerini çalıştırmak için bir hesaplama örneğine ihtiyacınız var. Bir işlem örneği oluşturmak ve çalıştırmak için, çalışma alanınızın bölgesinde kullanılabilir VM kotası gerekir ve örnek çalıştığı süre boyunca ücretlendirmeye neden olabilir.
Çalışma alanınızdan not defterlerine erişme
Jupyter not defterlerini düzenlemek ve çalıştırmak için çalışma alanınızın Not Defterleri bölümünü kullanın.
- Azure Machine Learning stüdyosu oturum açın
- Henüz açık değilse çalışma alanınızı seçin
- Sol tarafta Not Defterleri'ni seçin
Not defterini düzenleme
Not defterini düzenlemek için çalışma alanınızın Kullanıcı dosyaları bölümünde bulunan herhangi bir not defterini açın. Düzenlemek istediğiniz hücreyi seçin. Bu bölümde not defteriniz yoksa bkz . Çalışma alanınızda dosya oluşturma ve yönetme.
Bir işlem örneğine bağlanmadan not defterini düzenleyebilirsiniz. Not defterindeki hücreleri çalıştırmak istediğinizde, bir işlem örneği seçin veya oluşturun. Durdurulmuş bir işlem örneği seçerseniz, ilk hücreyi çalıştırdığınızda otomatik olarak başlatılır.
İşlem örneği çalışırken, herhangi bir Python not defterinde Intellisense tarafından desteklenen kod tamamlama özelliğini de kullanabilirsiniz.
İşlem örneği çalışırken, not defteri araç çubuğundan Jupyter veya JupyterLab'i başlatabilirsiniz. Azure Machine Learning, Microsoft Desteği sınırının dışında açık kaynak ürünler olduğundan Jupyter veya JupyterLab'den güncelleştirme sağlamaz ve hataları düzeltmez.
Odak modu
Etkin sekmelerinize odaklanabilmeniz için mevcut görünümünüzü genişletmek üzere odak modunu kullanın. Odak modu, Not Defterleri dosya gezginini gizler.
Not defteri araç çubuğunda Odak modu'nu seçerek odak modunu açın. Pencere genişliğinize bağlı olarak, araç araç çubuğunuzdaki ... menü öğesinin altında bulunabilir.
Odak modundayken Standart görünüm'ü seçerek standart görünüme dönün.
Kod tamamlama (IntelliSense)
IntelliSense , birçok özelliği içeren bir kod tamamlama yardımıdır: Liste Üyeleri, Parametre Bilgileri, Hızlı Bilgi ve Tam Word. Yalnızca birkaç tuş vuruşuyla şunları yapabilirsiniz:
- Kullandığınız kod hakkında daha fazla bilgi edinin
- Yazdığınız parametreleri takip etme
- Özelliklere ve yöntemlere çağrı ekleme
Kod parçacıkları ekleme (önizleme)
IntelliSense kod parçacıklarını tetikleme için Ctrl+Ara Çubuğu tuşlarını kullanın. Öneriler arasında ilerleyin veya eklemek istediğiniz kodu bulmak için yazmaya başlayın. Kod ekledikten sonra, bağımsız değişkenleri sekme tuşuyla kullanarak kodu kendi kullanımınıza göre özelleştirin.
Bu kod parçacıkları, not defterinizi VS Code'da açtığınızda da kullanılabilir.
Kod parçacığı panelini açmak için not defteri araç çubuğunu kullanarak kod parçacıkları listesine göz atabilir ve bu listede arama yapabilirsiniz.
Kod parçacıkları panelinden, yeni kod parçacıkları eklemek için bir istek de gönderebilirsiniz.
Not defterini paylaşma
Not defterleriniz çalışma alanınızın depolama hesabında saklanır ve çalışma alanınıza erişim düzeyine bağlı olarak başkalarıyla paylaşılabilir. Uygun erişime sahip oldukları sürece not defterini açabilir ve düzenleyebilirler. Örneğin, Katkıda Bulunan not defterini düzenleyebilirken, Okuyucu onu yalnızca görüntüleyebilir.
Çalışma alanınızın diğer kullanıcıları not defterinizi Azure Machine Learning stüdyosu Not Defterleri, Kullanıcı dosyaları bölümünde bulabilir. Not defterleriniz varsayılan olarak kullanıcı adınızın bulunduğu bir klasörde bulunur ve diğer kişiler bu klasöre buradan erişebilir.
Ayrıca, not defterini açtığınızda tarayıcınızdan URL'yi kopyalayıp başkalarına gönderebilirsiniz. Çalışma alanınıza uygun erişime sahip oldukları sürece not defterini açabilirler.
İşlem örneklerini paylaşmadığınızdan, not defterinizi çalıştıran diğer kullanıcılar kendi işlem örneklerini kullanır.
Not defteri yorumlarıyla birlikte çalışın
Not defterinize erişimi olan diğer kişilerle işbirliği yapmak için not defteri açıklamasını kullanın.
Not defterinin üst kısmındaki Not Defteri açıklamaları aracıyla açıklamalar bölmesini açıp kapatın. Ekranınız yeterince geniş değilse, önce araç kümesinin sonundaki ... öğesini seçerek bu aracı bulun.
Açıklamalar bölmesi görünür olsun veya olmasın, herhangi bir kod hücresine açıklama ekleyebilirsiniz:
- Kod hücresinde metin seçin. Yalnızca kod hücresindeki metinlere açıklama ekleyebilirsiniz.
-
Açıklamanızı oluşturmak için Yeni açıklama yazışması aracını kullanın.
- Açıklamalar bölmesi daha önce gizliyse, şimdi açılır.
- Açıklamanızı yazın ve araçla gönderin veya Ctrl+Enter tuşlarını kullanın.
- Bir yorum yayınlandıktan sonra, şunları yapmak için sağ üstteki ... seçeneğini belirleyin:
- Açıklamayı düzenleme
- İş parçacığını çözümle
- İş parçacığını sil
Yorum metni, kodda mor renkle vurgulanmış olarak görünür. Açıklamalar bölmesinde bir açıklama seçtiğinizde, not defteriniz vurgulanan metni içeren hücreye kaydırılır.
Not
Açıklamalar kod hücresinin meta verilerine kaydedilir.
Not defterinizi temizleme (önizleme)
Not defteri oluştururken genellikle veri araştırma veya hata ayıklama için kullandığınız hücrelere sahip olursunuz. Toplama özelliği, bu gereksiz hücreler olmadan temiz bir not defteri oluşturmanıza yardımcı olur.
- Tüm not defteri hücrelerinizi çalıştırın.
- Yeni not defterinin çalışmasını istediğiniz kodu içeren hücreyi seçin. Örneğin, deneme gönderen kod veya belki de modeli kaydeden kod.
-
Hücre araç çubuğunda görüntülenen Topla simgesini seçin.
- Yeni "toplanmış" not defterinizin adını girin.
Yeni not defteri yalnızca kod hücreleri içerir ve bir araya getirme için seçtiğiniz hücreyle aynı sonuçları üretmek için gerekli olan tüm hücreleri içerir.
Not defterini kaydetme ve denetleme noktası
Bir ipynb dosyası oluşturduğunuzda Azure Machine Learning bir denetim noktası dosyası oluşturur.
Not defterini el ile kaydetmek için not defteri araç çubuğunda menüyü ve ardından Dosya>Kaydet ve denetim noktası'nı seçin ve not defteriyle ilişkilendirilmiş bir denetim noktası dosyası ekler.
Her not defteri her 30 saniyede bir otomatik olarak kaydedilir. Otomatik Kaydet, denetim noktası dosyasını değil yalnızca ilk ipynb dosyasını güncelleştirir.
Adlandırılmış bir denetim noktası oluşturmak ve not defterini kaydedilmiş bir denetim noktasına geri döndürmek için not defteri menüsünde Denetim Noktaları'nı seçin.
Not defterini dışa aktar
Not defterini desteklenen türlerden biri olarak dışa aktarmak için, not defteri araç çubuğunda menüyü ve ardından Farklı Dışa Aktar'ı seçin:
- Piton
- HTML
- LaTeX
Dışarı aktarılan dosya bilgisayarınıza kaydedilir.
Not defteri veya Python betiği çalıştırın
Not defterini veya Python betiğini çalıştırmak için önce çalışan bir işlem örneğine bağlanırsınız.
İşlem örneğine sahip değilseniz, aşağıdaki adımları kullanarak bir tane oluşturun:
- Not defteri veya betik araç çubuğunda, Compute açılır listesinin sağında + Yeni İşlem seçeneğini belirleyin. Ekran boyutunuz bağlı olarak, denetim bir ... menüsünün altında bulunabilir.
- İşlem'i adlandırın ve bir Sanal Makine Boyutu seçin.
- Oluştur'u belirleyin.
- İşlem örneği dosyaya otomatik olarak bağlanır. Artık işlem örneğinin solundaki aracı kullanarak not defteri hücrelerini veya Python betiğini çalıştırabilirsiniz.
- Not defteri veya betik araç çubuğunda, Compute açılır listesinin sağında + Yeni İşlem seçeneğini belirleyin. Ekran boyutunuz bağlı olarak, denetim bir ... menüsünün altında bulunabilir.
Durdurulmuş bir işlem örneğiniz varsa, İşlem açılır menüsünün sağındaki İşlemi başlat seçeneğini belirleyin. Ekran boyutunuz bağlı olarak, denetim bir ... menüsünün altında bulunabilir.
Bir işlem örneğine bağlandıktan sonra, araç çubuğunu kullanarak not defterindeki tüm hücreleri veya Control + Enter tuşlarını kullanarak seçili tek bir hücreyi çalıştırın.
Bir hücre başarıyla çalıştırıldığında, çalıştırma sayısı artar ve çıktılar hücrenin altında görüntülenir. Çalıştırma tamamlandığında çekirdek durumu boşta duruma döner.
Oluşturduğunuz işlem örneklerini yalnızca siz görebilir ve kullanabilirsiniz. Kullanıcı dosyalarınız makineden ayrı olarak depolanır ve çalışma alanında tüm işlem örnekleri arasında paylaşılır.
Not defterindeki değişkenleri keşfetme
Not defteri araç çubuğunda, değişken gezgini aracını kullanarak not defterinizde oluşturulan tüm değişkenlerin adını, türünü, uzunluğunu ve örnek değerlerini gösterin.
Değişken gezgini penceresini göstermek için aracı seçin.
İçindekiler tablosuyla gezinme
not defteri araç çubuğunda içindekiler tablosunu görüntülemek veya gizlemek için İçindekiler tablosu aracını kullanın. Bir markdown hücresini başlıkla başlattığınızda, içindekiler tablosuna eklenir. Not defterindeki bu hücreye gitmek için tablodan bir girdi seçin.
Not defteri ortamını değiştirme
Not defteri araç çubuğu, not defterinizin çalıştığı ortamı değiştirmenize olanak tanır.
Bu eylemler not defteri durumunu veya not defterindeki değişkenlerin değerlerini değiştirmez:
| Eylem | Sonuç |
|---|---|
| Çekirdeği durdur | Çalışan tüm hücreleri durdurur. Bir hücre çalıştırılırsa çekirdek otomatik olarak yeniden başlatılır. |
| Başka bir çalışma alanı bölümüne gitme | Çalışan hücreler durdurulur. |
Bu eylemler not defteri durumunu sıfırlar ve not defterindeki tüm değişkenleri sıfırlar.
| Eylem | Sonuç |
|---|---|
| Çekirdeği değiştirme | Dizüstü bilgisayar yeni bir kernel kullanıyor |
| İşlem kaynağını değiştir | Notebook, yeni işlem kaynağını otomatik olarak kullanır. |
| Hesaplamayı sıfırla | Bir hücreyi çalıştırmayı denediğinizde yeniden başlar |
| İşlemi durdurma | Hiçbir hücre çalışmayacak |
| Jupyter veya JupyterLab'de not defterini açma | Not defteri yeni bir sekmede açıldı. |
Yeni çekirdekler ekleme
İşlem örneğinize yeni çekirdekler oluşturmak ve eklemek için terminali kullanın. Not defteri, bağlı işlem örneğinde yüklü olan tüm Jupyter çekirdeklerini otomatik olarak bulur.
Sağdaki çekirdek açılır listesini kullanarak yüklü çekirdeklerden herhangi birine geçin.
Paketleri yönetme
İşlem örneğiniz birden fazla çekirdeğe sahip olduğundan, paketleri o anda çalışan çekirdeğe yükleyen %pip veya %condasihirli işlevleri kullandığınızdan emin olun. Tüm paketlere (o anda çalışan çekirdeğin dışındaki paketler dahil) atıfta bulunan !pip veya !conda kullanmayın.
Durum göstergeleri
Compute açılır listesinin yanındaki bir gösterge, durumunu gösterir. Durum, açılan listede de gösterilir.
| Renk | İşlem durumu |
|---|---|
| Yeşil | İşlem çalışıyor |
| Kırmızı | İşlem başarısız oldu |
| Siyah | İşlem durduruldu |
| Açık Mavi | İşlem oluşturma, başlatma, yeniden başlatma, Ayarlama |
| Gri | Bilgi işlem silme, durdurma |
Kernel açılır listesinin yanındaki bir gösterge, durumunu gösterir.
| Renk | Çekirdek durumu |
|---|---|
| Yeşil | Çekirdek bağlı, boşta, meşgul |
| Gri | Çekirdek bağlı değil |
İşlem ayrıntılarını bulma
İşlem örneklerinizle ilgili ayrıntıları Studio'daki İşlem sayfasında bulabilirsiniz.
Kullanışlı klavye kısayolları
Jupyter Notebooks'a benzer şekilde, Azure Machine Learning Stüdyosu notebook'ları modal bir kullanıcı arabirimine sahiptir. Klavye, not defteri hücresinin hangi modda olduğuna bağlı olarak farklı şeyler yapar. Azure Machine Learning stüdyosu not defterleri, belirli bir kod hücresi için şu iki modu destekler: komut modu ve düzenleme modu.
Komut modu kısayolları
Bir hücre, yazmanızı isteyen metin imleci olmadığında komut modundadır. Bir hücre Komut modundayken, not defterini bir bütün olarak düzenleyebilirsiniz, ancak tek tek hücrelere yazamayın.
ESC tuşuna basarak veya fareyi kullanarak bir hücrenin düzenleyici alanının dışında bir yeri seçerek komut moduna girin.
| Kısayol | Açıklama |
|---|---|
| Giriniz | Düzenleme moduna girme |
| Shift + Enter | Hücreyi çalıştır, aşağıdakini seç |
| Control/Command + Enter düğmesi | Hücreyi çalıştırma |
| Alt + Enter | Hücreyi çalıştır, altına kod hücresi ekle |
| Control/Kontrol + Komut/Command + Alt + Enter/Giriş | Hücreyi çalıştır, aşağıya Markdown hücresi ekle |
| Alt + R | Tümünü çalıştır |
| Y | Hücreyi koda dönüştürme |
| M | Hücreyi Markdown’a dönüştür |
| Yukarı/K | Yukarıdaki hücreyi seçin |
| Aşağı/J | Aşağıdaki hücreyi seçin |
| A | Yukarı kod hücresi ekle |
| B | Altına kod hücresi ekle |
| Ctrl/Command + Shift + A | Üstüne markdown hücresi ekle |
| Kontrol/Command + Shift + B | Altına markdown hücresi ekle |
| X | Seçili hücreyi kes |
| C | Seçili hücreyi kopyala |
| Shift + V | Seçili hücreyi yukarıya yapıştır |
| V | Seçili hücreyi aşağıya yapıştır |
| D D | Seçili hücreyi sil |
| O | Çıkışı aç/kapat |
| Shift + O | Çıkış kaydırmayı açma/kapatma |
| Ben Ben | Kesinti çekirdeği |
| 0 0 | Çekirdeği yeniden başlatma |
| Shift + Ara Çubuğu | Yukarı kaydır |
| Uzay | Aşağı kaydırın |
| Sekme | Odağı bir sonraki odaklanılabilir öğeye değiştirme (sekme yakalama devre dışı bırakıldığında) |
| Kontrol/Kumanda + S | Not defterini kaydetme |
| 1 | h1 olarak değiştir |
| 2 | h2 olarak değiştir |
| 3 | h3 olarak değiştir |
| 4 | h4 olarak değiştir |
| 5 | h5 olarak değiştir |
| 6 | h6 olarak değiştir |
Düzenleme modu kısayolları
Düzenleme modu, düzenleyici alanına yazmanızı isteyen bir metin imleciyle gösterilir. Bir hücre düzenleme modundayken, hücreye yazabilirsiniz. Düzenleme moduna geçmek için Enter tuşuna basın veya bir hücrenin düzenleyici alanını seçin. Düzenleme modundaki hücrede imleci görürsünüz.
Aşağıdaki tuş vuruşu kısayollarını kullanarak, Düzenleme modundayken Azure Machine Learning not defterlerinde daha kolay gezinebilir ve kod çalıştırabilirsiniz.
| Kısayol | Açıklama |
|---|---|
| Kaçmak | Komut moduna girme |
| Control/Command + Boşluk tuşu | IntelliSense'i etkinleştirme |
| Shift + Enter | Hücreyi çalıştır, aşağıdakini seç |
| Control/Command + Enter düğmesi | Hücreyi çalıştırma |
| Alt + Enter | Hücreyi çalıştır, altına kod hücresi ekle |
| Control/Kontrol + Komut/Command + Alt + Enter/Giriş | Hücreyi çalıştır, aşağıya Markdown hücresi ekle |
| Alt + R | Tüm hücreleri çalıştır |
| Yukarı | İmleci yukarı veya önceki hücreye taşıma |
| Aşağı | İmleci aşağı veya sonraki hücreye taşıma |
| Kontrol/Kumanda + S | Not defterini kaydetme |
| Control/Command + Yukarı | Hücre başlangıcına gitme |
| Kontrol/Komut + Aşağı | Hücre sonuna git |
| Sekme | Kod tamamlama veya girinti (Tab tuşu yakalama etkinse) |
| Control/Command + M | Sekme tuşağını etkinleştir/devre dışı bırak |
| Control/Komut + ] | Girinti |
| Kontrol/Command + [ | Girintiyi Azalt |
| Kontrol/Command + A | Tümünü seç |
| Kontrol/Kumanda + Z | Geri Al |
| Ctrl/Cmd + Shift + Z | Yinele |
| Kontrol/Komut + Y | Yeniden yap |
| Kontrol/Komut + Başlangıç | Hücre başlangıcına git |
| Kontrol/Komut + End Tuşu | Hücre sonuna git |
| Control/Command (Kontrol/Kumanda) + Sol | Bir sözcük sola git |
| Control/Command + Sağ Ok | Bir sözcük sağa git |
| Control/Command + Geri Al tuşu | Önceki sözcüğü sil |
| Ctrl/Command + Sil | Sonraki sözcüğü sil |
| Kontrol/Komut + / | Hücrede açıklamayı açma/kapatma |
Sorun giderme
Bir not defterine bağlanma: Bir not defterine bağlanamıyorsanız web yuvası iletişiminin devre dışı bırakılmadığından emin olun. İşlem örneği Jupyter işlevinin çalışması için web yuvası iletişiminin etkinleştirilmesi gerekir. Ağınızın websocket bağlantılarına izin verdiğinden emin olun (*.instances.azureml.net ve *.instances.azureml.ms).
Özel uç nokta: Bir işlem örneği özel uç nokta içeren bir çalışma alanına dağıtıldığında, yalnızca sanal ağ içinden erişilebilir. Özel DNS veya hosts dosyası kullanıyorsanız, <örnek adı>.<bölge>.instances.azureml.ms için çalışma alanınızın özel uç noktasının özel IP adresini kullanarak bir giriş ekleyin. Daha fazla bilgi için bkz. özelleştirilmiş DNS makalesi.
Çekirdek kilitlenmesi: Çekirdeğiniz kilitlendiyse ve yeniden başlatıldıysa, Jupyter günlüğüne bakmak ve diğer ayrıntıları bulmak için aşağıdaki komutu çalıştırabilirsiniz:
sudo journalctl -u jupyter. Çekirdek sorunları devam ederse daha fazla belleğe sahip bir işlem örneği kullanmayı göz önünde bulundurun.Süresi dolmuş belirteç: Süresi dolmuş belirteç sorunuyla karşılaşırsanız Azure Machine Learning Studio'da oturumu kapatın, yeniden oturum açın ve ardından not defteri çekirdeğini yeniden başlatın.
Dosya yükleme sınırı: Not defterinin dosya gezgini aracılığıyla bir dosyayı karşıya yüklerken, 5 TB'tan küçük dosyalarla sınırlısınız. Bundan daha büyük bir dosya yüklemeniz gerekiyorsa, verileri bir veri deposuna yüklemek için SDK'yı kullanmanızı öneririz. Daha fazla bilgi için bkz. Veri varlıkları oluşturma.