Translation not up to date
Knihovna ibm-watson-studio-lib je následníkem project-lib library. Přestože můžete nadále používat rozhraní API produktu project-lib ve vašich přenosných počítačích, měli byste uvažovat o migraci existujících zápisníků pro použití knihovny produktu ibm-watson-studio-lib .
Mezi výhody použití produktu ibm-watson-studio-lib patří:
- Rozhraní API pro procházení aktiv poskytuje přístup jen pro čtení ke všem typům aktiv, nejen k těm, které jsou výslovně podporovány knihovnou.
- Produkt
ibm-watson-studio-libpoužívá konstivé konvence pojmenování API, které strukturují dostupné funkce v závislosti na jejich oblasti aplikace.
Následující oddíly popisují změny, které je třeba provést v existujících zápisnících R, abyste mohli začít používat knihovnu ibm-watson-studio-lib .
Nastavení knihovny
Chcete-li začít používat produkt ibm-watson-studio-lib, musíte provést následující změny v existujících zápisnících:
V kódu pomocí změny project-lib :
library(projectLib)
project <- projectLib::Project$new("<ProjectId>", "ProjectToken")
Chcete-li provést následující použití produktu ibm-watson-studio-lib:
library(ibmWatsonStudioLib)
wslib <- access_project_or_space(list("token" = "ProjectToken"))
Nastavení knihovny v prostředí Spark
Chcete-li začít používat produkt ibm-watson-studio-libv prostředích Spark, musíte provést následující změny ve stávajících přenosných počítačích.
V kódu pomocí změny project-lib :
library(projectLib)
project <- projectLib::Project$new(sc, "<ProjectId>", "ProjectToken")
Chcete-li provést následující použití produktu ibm-watson-studio-lib:
library(ibmWatsonStudioLib)
wslib <- access_project_or_space(list("token" = "ProjectToken"))
wslib$spark$provide_spark_context(sc)
Použití knihovny
Následující oddíly popisují změny kódu, které je třeba provést ve vašich přenosných počítačích při migraci funkcí v produktu project-lib na odpovídající funkce v produktu ibm-watson-studio-lib.
Získat informace o projektu
Chcete-li programově načíst informace související s projektem, je třeba změnit následující funkce:
Vypsat datová připojení
V kódu pomocí změny project-lib :
project$get_connections()
Chcete-li provést následující použití produktu ibm-watson-studio-lib:
assets <- wslib$list_connections()
wslib$show(assets)
S produktem ibm-watson-studio-libmůžete také zobrazit seznam připojených datových aktiv:
assets <- wslib$list_connected_data()
wslib$show(assets)
Vypsat datové soubory
Tato funkce vrací seznam datových souborů ve vašem projektu.
V kódu pomocí příkazu project-lib změňte použití:
project$get_files()
Chcete-li provést následující použití produktu ibm-watson-studio-lib:
assets <- wslib$list_stored_data()
wslib$show(assets)
Získat název nebo popis
V produktu ibm-watson-studio-libmůžete načíst veškerá metadata o projektu, například název projektu nebo jeho popis, prostřednictvím vstupního bodu wslib.here.
V kódu pomocí změny project-lib :
name <- project$get_name()
desc <- project$get_description()
Chcete-li provést následující použití produktu ibm-watson-studio-lib:
name <- wslib$here$get_name()
desc <- wslib$here$get_description()
Získat metadata
V produktu project-libnení žádná náhrada pro get_matadata :
project$get_metadata()
Funkce wslib$here ve ibm-watson-studio-lib odkrývá části těchto informací. V produktu wslib$herejsou k dispozici následující funkce:
wslib$here$get_name(): Vrací název projektuwslib$here$get_description(): Vrací popis proejct.wslib$here$get_ID(): Vrací ID projektuwslib$here$get_storage(): Vrací metadata úložiště
Získat metadata úložiště
V kódu pomocí změny project-lib :
project$get_storage_metadata()
Chcete-li provést následující použití produktu ibm-watson-studio-lib:
wslib$here$get_storage()
Načtení dat
Chcete-li přistupovat k datům v souboru, je třeba změnit následující funkce.
V kódu pomocí změny project-lib :
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)
Chcete-li provést následující použití produktu ibm-watson-studio-lib:
buffer <- wslib$load_data("MyAssetName.csv")
Produkt ibm-watson-studio-lib kromě toho nabízí funkci pro stažení datového aktiva a uložení v lokálním systému souborů:
info <- wslib$download_file("MyAssetName.csv", "MyLocalFile.csv")
uložit data
Chcete-li uložit data do souboru, musíte změnit následující funkce.
V kódu pomocí změny project-lib (a ve všech změnách directStorage=FALSE a setProjectAsset=TRUE):
project$save_data("NewAssetName.csv", data)
project$save_data("MyAssetName.csv", data, overwrite=TRUE)
Chcete-li provést následující použití produktu ibm-watson-studio-lib:
asset <- wslib$save_data("NewAssetName.csv", data)
wslib$show(asset)
asset <- wslib$save_data("MyAssetName.csv", data, overwrite=TRUE)
wslib$show(asset)
Produkt ibm-watson-studio-lib kromě toho nabízí funkci pro odeslání lokálního souboru do úložiště projektu a vytvoření datového aktiva:
asset <- wslib$upload_file("MyLocalFile.csv", "MyAssetName.csv")
wslib$show(asset)
Získat informace o připojení
Chcete-li vrátit metadata přidružená k připojení, je třeba změnit následující funkce.
V kódu pomocí změny project-lib :
connprops <- project$get_connection(name="MyConnection")
Chcete-li provést následující použití produktu ibm-watson-studio-lib:
connprops <- wslib$get_connection("MyConnection")
Získat informace o připojených datech
Chcete-li vrátit metadata přidružená k propojenému datovému aktivu, musíte změnit následující funkce.
V kódu pomocí změny project-lib :
dataprops <- project$get_connected_data(name="MyConnectedData")
Chcete-li provést následující použití produktu ibm-watson-studio-lib:
dataprops <- wslib$get_connected_data("MyConnectedData")
Přistoupit k aktivu podle ID namísto názvu
Metadata připojení nebo připojeného datového aktiva můžete vrátit přístupem k aktivu pomocí ID namísto podle názvu.
V produktu project-lib změňte:
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")
Chcete-li provést následující použití produktu ibm-watson-studio-lib:
connprops <- wslib$by_id$get_connection("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx")
dataprops <- wslib$by_id$get_connected_data("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx")
V produktu project-libnení možné přistupovat k souborům (uloženým datovým aktivům) podle ID. Toto můžete provést pouze podle názvu. Knihovna ibm-watson-studio-lib podporuje přístup k souborům podle ID. Viz Použití ibm-watson-studio-lib.
Načíst aktiva podle typu aktiva
Když načítáte seznam všech aktiv projektu, můžete předat volitelný parametr assetType do funkce get_assets , která vám umožňuje filtrovat aktiva podle typu. Akceptované hodnoty pro tento parametr v project-lib jsou data_asset, connection a asset.
V kódu pomocí změny project-lib :
project$get_assets()
# Or, for a supported asset type:
project$get_assets("<asset_type>")
# Or:
project$get_assets(assetType="<asset_type>")
Chcete-li provést následující použití produktu ibm-watson-studio-lib:
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)
Chcete-li zobrazit seznam dostupných typů aktiv, použijte:
assettypes <- wslib$assets$list_asset_types()
wslib$show(assettypes)
Podpora parku Spark
Chcete-li pracovat se Spark, musíte změnit funkce, které umožňují podporu Spark a načtení adresy URL do souboru.
Nastavení podpory produktu Spark
Chcete-li nastavit podporu produktu Spark:
V kódu pomocí změny project-lib :
# Provide SparkContext during setup
library(projectLib)
project <- projectLib::Project$new(sc, "<ProjectId>", "ProjectToken")
Chcete-li provést následující použití produktu ibm-watson-studio-lib:
library(ibmWatsonStudioLib) wslib <- access_project_or_space(list("token" = "ProjectToken"))
# provide SparkContext after initialization
wslib$spark$provide_spark_context(sc)
Načíst adresu URL pro přístup k souboru ze Spark
Chcete-li získat adresu URL pro přístup k souboru, na který odkazuje aktivum ze Spark přes Hadoop, postupujte takto:
V kódu pomocí změny project-lib :
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)
Chcete-li provést následující použití produktu ibm-watson-studio-lib:
url = wslib$spark$get_data_url("MyAssetName.csv")
Získat adresu URL souboru pro použití se Spark
Načtení adresy URL pro přístup k souboru, na který odkazuje aktivum ze Spark přes Hadoop.
V kódu pomocí změny project-lib :
url = project$get_file_url("MyFileName.csv, directStorage=TRUE)
# or
url = project$get_file_url("MyFileName.csv", directOsRetrieval=TRUE)
Chcete-li provést následující použití produktu ibm-watson-studio-lib:
wslib$spark$storage$get_data_url("MyFileName.csv")
Přístup k úložišti projektu přímo
Můžete načíst data z úložiště projektu nebo uložit data do úložiště projektu bez synchronizace aktiv projektu.
Načtení dat
Chcete-li načíst data z úložiště projektu:
V kódu pomocí změny project-lib :
project$get_file("MyFileName.csv", directStorage=TRUE)
# Or:
project$get_file("MyFileName.csv", directOsRetrieval=TRUE)
Chcete-li provést následující použití produktu ibm-watson-studio-lib:
wslib$storage$fetch_data("MyFileName.csv")
uložit data
Chcete-li uložit data do souboru v úložišti projektu:
V kódu pomocí změny project-lib :
project$save_data("NewFileName.csv", data, directStorage=TRUE)
# Or:
project$save_data("NewFileName.csv", data, setProjectAsset=FALSE)
Chcete-li provést následující použití produktu ibm-watson-studio-lib:
wslib$storage$store_data("NewFileName.csv", data)
V kódu pomocí změny project-lib :
# 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)
Chcete-li provést následující použití produktu ibm-watson-studio-lib:
wslib$storage$store_data("MyFileName.csv", data, overwrite=TRUE)
Additionally, ` ibm-watson-lib-lib ` poskytuje funkci pro stažení souboru z úložiště projektu do lokálního systému souborů:
wslib$storage$download_file("MyStorageFile.csv", "MyLocalFile.csv")
Můžete také zaregistrovat soubor v úložišti projektu jako datové aktivum pomocí:
wslib$storage$register_asset("MyStorageFile.csv", "MyAssetName.csv")
Další informace
Chcete-li použít knihovnu ibm-watson-studio-lib pro R v přenosných počítačích, prohlédněte si ibm-watson-lib-lib for R.
Nadřízené téma: Použití ibm-watson-studio-lib