ibm-watson-studio-lib kitaplığı, project-lib library' in ardılıdır. Dizüstü bilgisayarlarınızda hala project-lib API ' yı kullanmaya devam edebilmenize rağmen, ibm-watson-studio-lib kitaplığını kullanmak için var olan dizüstü bilgisayarları yeni düzeye geçirmeyi düşünmelisiniz.
ibm-watson-studio-lib kullanmanın avantajları arasında şunlar yer alır:
- Varlık göz atma API 'si, yalnızca kitaplık tarafından açıkça desteklenenler için değil, tüm varlık tiplerine salt okunur erişim sağlar.
ibm-watson-studio-lib, kullanılabilir işlevleri uygulama alanına göre yapılandıran bir construment API adlandırma kuralı kullanır.
The following sections describe the changes you need to make in existing R notebooks to start using the the ibm-watson-studio-lib library.
Kitaplığı ayarla
ibm-watson-studio-libolanağını kullanmaya başlamak için, varolan defterlerde aşağıdaki değişiklikleri yapmanız gerekir:
project-lib değişikliği kullanılarak kodda:
library(projectLib)
project <- projectLib::Project$new("<ProjectId>", "ProjectToken")
ibm-watson-studio-libkomutunu kullanarak aşağıdaki bilgileri kullanın:
library(ibmWatsonStudioLib)
wslib <- access_project_or_space(list("token" = "ProjectToken"))
Spark ortamlarındaki kitaplığı ayarla
Spark ortamlarında ibm-watson-studio-libözelliğini kullanmaya başlamak için var olan defterlerde aşağıdaki değişiklikleri yapmanız gerekir.
project-lib değişikliği kullanılarak kodda:
library(projectLib)
project <- projectLib::Project$new(sc, "<ProjectId>", "ProjectToken")
ibm-watson-studio-libkomutunu kullanarak aşağıdaki bilgileri kullanın:
library(ibmWatsonStudioLib)
wslib <- access_project_or_space(list("token" = "ProjectToken"))
wslib$spark$provide_spark_context(sc)
Kitaplık kullanımı
Aşağıdaki kısımlarda, project-lib içindeki işlevleri ibm-watson-studio-libiçindeki ilgili işlevlere geçirirken, not defterlerinizde yapmanız gereken kod değişiklikleri açıklanmaktadır.
Proje bilgilerini al
Projeyle ilgili bilgileri programlı olarak getirmek için aşağıdaki işlevleri değiştirmeniz gerekir:
Veri bağlantılarını listele
project-lib değişikliği kullanılarak kodda:
project$get_connections()
ibm-watson-studio-libkomutunu kullanarak aşağıdaki bilgileri kullanın:
assets <- wslib$list_connections()
wslib$show(assets)
Diğer bir seçenek olarak, ibm-watson-studio-libile bağlı veri varlıklarını listeleyebilirsiniz:
assets <- wslib$list_connected_data()
wslib$show(assets)
Veri dosyalarını listele
Bu işlev, projenizdeki veri kütüklerinin listesini döndürür.
In code using project-lib change using:
project$get_files()
ibm-watson-studio-libkomutunu kullanarak aşağıdaki bilgileri kullanın:
assets <- wslib$list_stored_data()
wslib$show(assets)
Adı ya da tanımı al
In ibm-watson-studio-lib, you can retrieve any metadata about the project, for example the name of a project or its description, via the entrypoint wslib.here.
project-lib değişikliği kullanılarak kodda:
name <- project$get_name()
desc <- project$get_description()
ibm-watson-studio-libkomutunu kullanarak aşağıdaki bilgileri kullanın:
name <- wslib$here$get_name()
desc <- wslib$here$get_description()
Meta Veri Al
project-libiçinde get_matadata için herhangi bir yerine koyma değeri yoktur:
project$get_metadata()
ibm-watson-studio-lib içindeki wslib$here işlevi, bu bilgilerin çeşitli kısımlarıyla ortaya çıkarılıyor. Aşağıdaki işlevler wslib$hereiçinde bulunur:
wslib$here$get_name(): Proje adını döndürür.wslib$here$get_description(): Proejct açıklamasını döndürür.wslib$here$get_ID(): Proje tanıtıcısını döndürür.wslib$here$get_storage(): Depolama meta verilerini döndürür.
Depolama meta verilerini al
project-lib değişikliği kullanılarak kodda:
project$get_storage_metadata()
ibm-watson-studio-libkomutunu kullanarak aşağıdaki bilgileri kullanın:
wslib$here$get_storage()
Verileri getir
Bir dosyadaki verilere erişmek için aşağıdaki işlevleri değiştirmeniz gerekir.
project-lib değişikliği kullanılarak kodda:
buffer <- project$get_file("MyAssetName.csv")
# or, without direct storage access:
buffer <- project$get_file("MyAssetName.csv", directStorage=FALSE)
# or:
buffer <- project$get_file("MyAssetName.csv", directOsRetrieval=FALSE)
ibm-watson-studio-libkomutunu kullanarak aşağıdaki bilgileri kullanın:
buffer <- wslib$load_data("MyAssetName.csv")
Buna ek olarak, ibm-watson-studio-lib , bir veri varlığını karşıdan yüklemek ve yerel dosya sisteminde depolamak için bir işlev sunar:
info <- wslib$download_file("MyAssetName.csv", "MyLocalFile.csv")
Verileri kaydetme
Verileri bir dosyaya saklamak için aşağıdaki işlevleri değiştirmeniz gerekir.
project-lib değişikliği kullanılarak kodda (ve tüm directStorage=FALSE ve setProjectAsset=TRUEçeşitleri için):
project$save_data("NewAssetName.csv", data)
project$save_data("MyAssetName.csv", data, overwrite=TRUE)
ibm-watson-studio-libkomutunu kullanarak aşağıdaki bilgileri kullanın:
asset <- wslib$save_data("NewAssetName.csv", data)
wslib$show(asset)
asset <- wslib$save_data("MyAssetName.csv", data, overwrite=TRUE)
wslib$show(asset)
Buna ek olarak, ibm-watson-studio-lib , yerel bir dosyayı proje depolamaya yüklemek ve bir veri varlığı yaratmak için bir işlev sunar:
asset <- wslib$upload_file("MyLocalFile.csv", "MyAssetName.csv")
wslib$show(asset)
Bağlantı bilgilerini al
Bir bağlantıyla ilişkili meta verileri döndürmek için, aşağıdaki işlevleri değiştirmeniz gerekir.
project-lib değişikliği kullanılarak kodda:
connprops <- project$get_connection(name="MyConnection")
ibm-watson-studio-libkomutunu kullanarak aşağıdaki bilgileri kullanın:
connprops <- wslib$get_connection("MyConnection")
Bağlanılan veri bilgilerini al
Bağlı bir veri varlığıyla ilişkili meta verileri döndürmek için, aşağıdaki işlevleri değiştirmeniz gerekir.
project-lib değişikliği kullanılarak kodda:
dataprops <- project$get_connected_data(name="MyConnectedData")
ibm-watson-studio-libkomutunu kullanarak aşağıdaki bilgileri kullanın:
dataprops <- wslib$get_connected_data("MyConnectedData")
Varlığa ad yerine tanıtıcıya göre erişim
Varlığa, ad yerine tanıtıcıya göre erişerek, bir bağlantının ya da bağlı veri varlığının meta verilerini döndürebilirsiniz.
In project-lib change:
connprops <- project$get_connection(id="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx")
# or:
connprops <- project$get_connection("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx")
# or:
datapros <- project$get_connected_data(id="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx")
# or:
datapros <- project$get_connected_data("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx")
ibm-watson-studio-libkomutunu kullanarak aşağıdaki bilgileri kullanın:
connprops <- wslib$by_id$get_connection("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx")
dataprops <- wslib$by_id$get_connected_data("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx")
project-lib' ta, dosyalara (saklanan veri varlıkları) tanıtıcıya göre erişimleri yapılamaz. Bunu sadece isme göre yapabilirsiniz. ibm-watson-studio-lib kitaplığı, dosyalara tanıtıcıya göre erişmeyi destekler. Bkz. Using ibm-watson-studio-lib.
Varlıkları varlık tipine göre getir
When you retrieve the list of all project assets, you can pass the optional parameter assetType to the function get_assets which allows you to filter assets by type. project-lib içinde bu parametre için kabul edilen değerler data_asset, connection ve asset' dir.
project-lib değişikliği kullanılarak kodda:
project$get_assets()
# Or, for a supported asset type:
project$get_assets("<asset_type>")
# Or:
project$get_assets(assetType="<asset_type>")
ibm-watson-studio-libkomutunu kullanarak aşağıdaki bilgileri kullanın:
assets <- wslib$assets$list_assets("asset")
wslib$show(assets)
# Or, for a specific asset type:
assets <- wslib$assets$list_assets("<asset_type>")
# Example, list all notebooks:
notebook_assets <- wslib$assets$list_assets("notebook")
wslib$show(notebook_assets)
Kullanılabilir varlık tiplerini listelemek için şunu kullanın:
assettypes <- wslib$assets$list_asset_types()
wslib$show(assettypes)
Spark desteği
Spark ile çalışmak için, Spark desteğini etkinleştiren ve URL ' yi bir dosyaya alma işlevini etkinleştirmeniz gereken işlevleri değiştirmeniz gerekir.
Spark desteğini ayarla
Spark desteği ayarlamak için:
project-lib değişikliği kullanılarak kodda:
# Provide SparkContext during setup
library(projectLib)
project <- projectLib::Project$new(sc, "<ProjectId>", "ProjectToken")
ibm-watson-studio-libkomutunu kullanarak aşağıdaki bilgileri kullanın:
library(ibmWatsonStudioLib) wslib <- access_project_or_space(list("token" = "ProjectToken"))
# provide SparkContext after initialization
wslib$spark$provide_spark_context(sc)
Spark 'tan bir dosyaya erişmek için URL ' yi al
To retrieve a URL to access a file referenced by an asset from Spark via Hadoop:
project-lib değişikliği kullanılarak kodda:
url = project$get_file_url("MyAssetName.csv")
# or
url = project$get_file_url("MyAssetName.csv", directStorage=FALSE)
# or
url = project$get_file_url("MyAssetName.csv", directOsRetrieval=FALSE)
ibm-watson-studio-libkomutunu kullanarak aşağıdaki bilgileri kullanın:
url = wslib$spark$get_data_url("MyAssetName.csv")
Spark ile kullanım için dosya URL 'sini al
Retrieve a URL to access a file referenced by an asset from Spark via Hadoop.
project-lib değişikliği kullanılarak kodda:
url = project$get_file_url("MyFileName.csv, directStorage=TRUE)
# or
url = project$get_file_url("MyFileName.csv", directOsRetrieval=TRUE)
ibm-watson-studio-libkomutunu kullanarak aşağıdaki bilgileri kullanın:
wslib$spark$storage$get_data_url("MyFileName.csv")
Doğrudan proje depolamaya erişin
Proje varlıklarını eşitlemeden proje depolama alanından verileri getirebilir ya da verileri proje depolamaya kaydedebilirsiniz.
Verileri getir
Verileri proje depolamasından almak için:
project-lib değişikliği kullanılarak kodda:
project$get_file("MyFileName.csv", directStorage=TRUE)
# Or:
project$get_file("MyFileName.csv", directOsRetrieval=TRUE)
ibm-watson-studio-libkomutunu kullanarak aşağıdaki bilgileri kullanın:
wslib$storage$fetch_data("MyFileName.csv")
Verileri kaydetme
Verileri proje depolamasındaki bir dosyaya saklamak için:
project-lib değişikliği kullanılarak kodda:
project$save_data("NewFileName.csv", data, directStorage=TRUE)
# Or:
project$save_data("NewFileName.csv", data, setProjectAsset=FALSE)
ibm-watson-studio-libkomutunu kullanarak aşağıdaki bilgileri kullanın:
wslib$storage$store_data("NewFileName.csv", data)
project-lib değişikliği kullanılarak kodda:
# Save (and overwrite if file exists) and do not create an asset in the project
project$save_data("MyFileName.csv", data, directStorage=TRUE, overwrite=TRUE)
# Or:
project$save_data("MyFileName.csv", data, setProjectAsset=FALSE, overwrite=TRUE)
ibm-watson-studio-libkomutunu kullanarak aşağıdaki bilgileri kullanın:
wslib$storage$store_data("MyFileName.csv", data, overwrite=TRUE)
Additionaly, ` ibm-watson-Studio-lib `, proje depolamasından yerel dosya sistemine bir dosya yüklemek için bir işlev sağlar:
wslib$storage$download_file("MyStorageFile.csv", "MyLocalFile.csv")
Aşağıdakileri kullanarak proje depolamasındaki bir dosyayı veri varlığı olarak kaydettirebilirsiniz:
wslib$storage$register_asset("MyStorageFile.csv", "MyAssetName.csv")
Daha fazla bilgi
ibm-watson-studio-lib kitaplığını not defterlerinde kullanmak üzereusekitaplığını kullanmak için bkz. ibm-watson-studio-lib for R.