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ím zápisnících Python , 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 :
from project_lib import Project
project = Project("<ProjectId>","<ProjectToken>")
Chcete-li provést následující použití produktu ibm-watson-studio-lib:
from ibm_watson_studio_lib import access_project_or_space
wslib = access_project_or_space({"token":"<ProjectToken>"})
Nastavení knihovny v prostředí Spark
Chcete-li začít používat produkt ibm-watson-studio-lib v 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 :
from project_lib import Project
project = Project(sc,"<ProjectId>","<ProjectToken>")
Chcete-li provést následující použití produktu ibm-watson-studio-lib:
from ibm_watson_studio_lib import access_project_or_space
wslib = access_project_or_space({"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í. Chcete-li zjistit, jaké informace metadat projektu jsou k dispozici, použijte:
help(wslib.here.API)
Například:
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", direct_storage=False)
# or:
buffer = project.get_file("MyAssetName.csv", direct_os_retrieval=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 direct_store=False a set_project_asset=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 asset_type 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(asset_type="<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
from project_lib import Project
project = Project(sc,"<ProjectId>","<ProjectToken>")
Chcete-li provést následující použití produktu ibm-watson-studio-lib:
from ibm_watson_studio_lib import access_project_or_space
wslib = access_project_or_space({'token':'<ProjectToken>'}
# provide SparkContext in a subsequent step
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", direct_storage=False)
# or
url = project.get_file_url("MyAssetName.csv", direct_os_retrieval=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 :
project.get_file_url("MyFileName.csv", direct_storage=True)
# or
project.get_file_url("MyFileName.csv", direct_os_retrieval=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", direct_storage=True)
# Or:
project.get_file("MyFileName.csv", direct_os_retrieval=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 :
# Save and do not create an asset in a project
project.save_data("NewFileName.csv", data, direct_storage=True)
# Or:
project.save_data("NewFileName.csv", data, set_project_asset=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, direct_storage=True, overwrite=True)
# Or:
project.save_data("MyFileName.csv", data, set_project_asset=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)
Kromě toho produkt ibm-watson-studio-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")
Soubor v úložišti projektu můžete také registrovat jako datové aktivum pomocí:
wslib.storage.register_asset("MyStorageFile.csv", "MyAssetName.csv")
Další informace
Chcete-li použít knihovnu ibm-watson-studio-lib pro Python v přenosných počítačích, prohlédněte si ibm-watson-studio-lib pro Python.
Nadřízené téma: Použití ibm-watson-studio-lib