0 / 0
Go back to the English version of the documentation
ibm-watson-studio-lib for R
Last updated: 10 Ağu 2023
ibm-watson-studio-lib for R

R için ibm-watson-studio-lib kitaplığı varlıklara erişim sağlar. Not defteri düzenleyicisinde ya da bir projedeki RStudio 'da oluşturulan not defterlerinde kullanılabilir. ibm-watson-studio-lib , diğer tüm varlık tipleri için göz atma işlevinin yanı sıra veri varlıkları ve bağlantılarıyla çalışma desteği sağlar.

İki tür veri varlığı vardır:

  • Saklanan veri varlıkları , geçerli projeyle ilişkili depodaki dosyalara başvuruda bulunur. Kitaplık bu dosyaları yükleyebilir ve saklayabilir. Bir megabyte 'tan büyük veriler için bu önerilmez. Kitaplık, verilerin tamamının bellekte tutulmasını gerektirir; bu da büyük veri kümeleri işlenirken verimsiz olabilir.
  • Bağlantılı veri varlıkları , bir bağlantı üzerinden erişilmesi gereken verileri temsil eder. Kitaplığı kullanarak, bağlı veri varlığının ve bağlantısının özelliklerini (meta verilerini) alabilirsiniz. İşlevler, bağlı bir veri varlığının verilerini döndürmez. Verilere erişmek için Kod parçacıkları panosunda Verileri oku seçeneğini tıklattığınızda sizin için oluşturulan kodu kullanabilir ya da kendi kodunuzu yazmanız gerekir.
Not: ` ibm-watson-studio-lib ` işlevleri, bir dosyaya veri kaydederken ya da dosyadan veri alınırken verileri kodlamaz ya da verilerin kodunu çözmez. Buna ek olarak, ` ibm-watson-studio-lib ` işlevleri bağlı klasör varlıklarına (proje depolama yolu üzerindeki dosyalar) erişmek için kullanılamaz.

ibm-watson-studio-lib kitaplığının ayarlanması

ibm-watson-studio-lib for R kitaplığı önceden kurulur ve defter düzenleyicisindeki bir not defterine doğrudan içe aktarılabilir. Not defterinizde ibm-watson-studio-lib kitaplığını kullanmak için projenin tanıtıcısı ve proje simgesi gerekir.

Proje simgesini not defterinize eklemek için:

  1. Not defteri araç çubuğunuzda Diğer simgesini ve ardından Proje simgesi ekle' yi tıklatın.

    Bir proje simgesi varsa, not defterinize aşağıdaki bilgilerle bir hücre eklenir:

    library(ibmWatsonStudioLib)
    wslib <- access_project_or_space(list("token"="<ProjectToken>"))
    

    <ProjectToken> , proje simgesinin değeridir.

    Bir iletide proje simgesi olmadığı söylenirse, proje simgesi yaratabileceğiniz projenin Erişim Denetimi sayfasına yönlendirilmek için iletideki bağlantıyı tıklatın. Bir proje simgesi yaratmak için uygun olmanız gerekir. Ayrıntılar için bkz. Proje simgesini el ile ekleme.

    Proje simgesi yaratmak için:

    1. Manage (Yönet) sekmesinden Access Control (Erişim Denetimi) sayfasını seçin ve Access tokens(Erişim belirteçleri) altındaki New access token (Yeni erişim simgesi) seçeneğini tıklatın.
    2. Bir ad girin, proje için Düzenleyici rolünü seçin ve bir belirteç oluşturun.
    3. Not defterinize geri dönün, not defteri araç çubuğundaki Diğer simgesini tıklatın ve ardından Proje simgesi ekle' yi tıklatın.

ibm-watson-studio-lib işlevleri

ibm-watson-studio-lib kitaplığı, aşağıdaki şekilde gruplanmış bir işlev kümesini gösterir:

Proje bilgilerini al

Kod geliştirirken, veri varlıklarının ya da bağlantılarının tam adlarını bilmiyor olabilirsiniz. Aşağıdaki işlevler, ilgili varlıkları seçebileceğiniz varlık listelerini sağlar. Tüm örneklerde, listeyi oldukça yazdırmak için wslib$show(assets) kullanabilirsiniz. Her öğenin dizini, öğenin önüne yazdırılır.

  • list_connections()

    Bu işlev, bağlantıların listesini döndürür. Döndürülen bağlantıların listesi herhangi bir ölçüte göre sıralanmaz ve işlevi yeniden çağırdığınızda değişebilir. Ad yerine bir liste öğesini get_connection function' e iletebilirsiniz.

    # Import the lib
    library("ibmWatsonStudioLib")
    wslib <- access_project_or_space(list("token"="<ProjectToken>"))
    
    assets <- wslib$list_connections()
    wslib$show(assets)
    connprops <- wslib$get_connection(assets[0])
    
  • list_connected_data()

    Bu işlev, bağlı veri varlıklarını döndürür. Döndürülen bağlantılı veri varlıkları listesi herhangi bir ölçüte göre sıralanmaz ve işlevi yeniden çağırdığınızda değişebilir. get_connected_data işlevine ad yerine bir liste öğesi geçirebilirsiniz.

  • list_stored_data()

    Bu işlev, saklanan veri varlıklarının (veri dosyaları) bir listesini döndürür. Döndürülen veri varlıkları listesi herhangi bir ölçüte göre sıralanmaz ve işlevi yeniden çağırdığınızda değişebilir. load_data ve save_data işlevlerine ad yerine bir liste öğesi geçirebilirsiniz.

    Not: Bağlı veri varlıklarını ve depolanan veri varlıklarını ayırt etmek için buluşsal bir uygulama uygulanır. Ancak, döndürülen listelerde yanlış türdeki bir veri varlığının görüntülendiği durumlar olabilir.
  • wslib$here Bu giriş noktasını kullanarak, kitaplığının çalıştığı projeyle ilgili meta verileri alabilirsiniz. wslib$here giriş noktası aşağıdaki işlevleri sağlar:

    • get_name()

      Bu işlev, projenin adını döndürür.

    • get_description()

      Bu işlev, projenin tanımını döndürür.

    • get_ID()

      Bu işlev, projenin tanıtıcısını döndürür.

    • get_storage()

      Bu işlev, projeye ilişkin depolama bilgilerini döndürür.

Kimlik doğrulama simgesini al

Bazı görevler bir kimlik doğrulama simgesi gerektirir. Örneğin, Watson Veri API 'siiçin kendi isteklerinizi çalıştırmak istiyorsanız, bir kimlik doğrulama belirtecine gereksinim duyarsınız.

Taşıyıcı simgesini almak için aşağıdaki işlevi kullanabilirsiniz:

  • get_current_token()

Örneğin:

library("ibmWatsonStudioLib")
wslib <- access_project_or_space(list("token"="<ProjectToken>"))
token <- wslib$auth$get_current_token()

Bu işlev, ibm-watson-studio-lib kitaplığı tarafından kullanılmakta olan taşıyıcı simgesini döndürür.

Verileri getir

Projenizdeki bir depolanan veri varlığından (bir dosyadan) veri almak için aşağıdaki işlevleri kullanabilirsiniz.

  • load_data(asset_name_or_item, attachment_type_or_item = NULL)

    Bu işlev, saklanan bir veri varlığının verilerini bayt arabelleğine yükler. İşlev çok büyük dosyalar için önerilmez.

    İşlev aşağıdaki parametreleri alır:

    • asset_name_or_item: (Gerekli) Saklanmış bir veri varlığının adını taşıyan bir dizgi ya da list_stored_data()tarafından döndürüleceklere benzer bir öğe.

    • attachment_type_or_item: (İsteğe bağlı) Yüklemek için ek tipi. Bir veri varlığının veri içeren birden çok eki olabilir. Bu parametre olmadan, varsayılan ek tipi ( data_asset ) yüklenir. Ek tipi data_assetdeğilse bu parametreyi belirtin. Örneğin, bir düz metin veri varlığının Natural Language Analysis 'den ekli bir profili varsa, bu data_profile_nluek tipi olarak yüklenebilir.

      Aşağıda, bir veri varlığının verilerini nasıl yükleyeceğinizi gösteren bir örnek verilmiştir:

      # Import the lib
      library("ibmWatsonStudioLib")
      wslib <- access_project_or_space(list("token"="<ProjectToken>"))
      
      # Fetch the data from a file
      my_file <- wslib$load_data("MyFile.csv")
      
      # Read the CSV data file into a data frame
      df <-  read.csv(text = rawToChar(my_file))
      head(df)
      
  • download_file(asset_name_or_item, file_name = NULL, attachment_type_or_item = NULL)

    Bu işlev, saklanan bir veri varlığının verilerini aşağı yükler ve yürütme ortamınızın dosya sisteminde belirtilen dosyada saklar. Dosya zaten varsa, dosyanın üzerine yazılır.

    İşlev aşağıdaki parametreleri alır:

    • asset_name_or_item: (Gerekli) Saklanmış bir veri varlığının adını taşıyan bir dizgi ya da list_stored_data()tarafından döndürüleceklere benzer bir öğe.

    • file_name: (İsteğe bağlı) Karşıdan yüklenen verilerin saklandığı dosyanın adı. Varsayılan değer olarak varlığın ek adını kullanır.

    • attachment_type_or_item: (İsteğe bağlı) Karşıdan yüklenecek ek tipi. Bir veri varlığının veri içeren birden çok eki olabilir. Bu parametre olmadan, varsayılan ek tipi olan data_asset karşıdan yüklenir. Ek tipi data_assetdeğilse bu parametreyi belirtin. Örneğin, bir düz metin veri varlığının Natural Language Analysis 'den ekli bir profili varsa, bu, data_profile_nluek tipi olarak yüklenmiş olarak indirgenebilir.

      Not defterinizde özel R komut dosyanızı kullanılabilir kılmak için download_file dosyasını nasıl kullanabileceğinizi gösteren bir örnek:

      # Import the lib
      library("ibmWatsonStudioLib")
      wslib <- access_project_or_space(list("token"="<ProjectToken>"))
      
      # Let's assume you have a R script "helpers.R" with helper functions on your local machine.
      # Upload the script to your project using the Data Panel on the right.
      
      # Download the script to the file system of your runtime
      wslib$download_file("helpers.R")
      
      # Source the script to use the contained functions, e.g. ‘my_func’, in your notebook.
      source("helpers.R")
      my_func()
      

Verileri kaydetme

Proje depolama biriminizde veri saklama işlevleri birden çok şey yapar:

  • Verileri proje deposunda sakla
  • Projenizdeki veri varlıkları listesindeki verileri görebilmek için, verileri projenize veri varlığı olarak ekleyin (bir varlık yaratarak ya da var olan bir varlığın üzerine yazarak).
  • Varlığı depodaki dosyayla ilişkilendirin.

Verileri saklamak için aşağıdaki işlevleri kullanabilirsiniz:

  • save_data(asset_name_or_item, data, overwrite = NULL, mime_type = NULL, file_name = NULL)

    Bu işlev, bellekteki verileri proje depolamasına kaydeder.

    İşlev aşağıdaki parametreleri alır:

    • asset_name_or_item: (Gerekli) list_stored_data()tarafından döndürülen, yaratılan varlık ya da liste öğesinin adı. Var olan bir dosyanın üzerine yazmak istiyorsanız öğeyi kullanabilirsiniz.

    • data: (Gerekli) Karşıya yüklenecek veriler. Beklenen veri tipi raw.

    • overwrite: (İsteğe Bağlı) Önceden varsa, saklanmış bir veri varlığının verilerinin üzerine yazar. Varsayılan değer yanlış (false) olarak ayarlanır. Ad yerine bir varlık öğesi geçirilirse, bu davranış varlığın üzerine yazılmasına neden olur.

    • mime_type: (İsteğe bağlı) Yaratılacak varlık için MIME tipi. Varsayılan olarak, MIME tipi varlık adı sonekinden saptanır. Varlık adlarını sonek olmadan kullanıyorsanız, burada MIME tipini belirtin. Örneğin, düz metin verileri için mime_type=application/text . Bir varlığın üzerine yazılırken bu parametre yoksayılır.

    • file_name: (İsteğe bağlı) Proje depolamasında kullanılacak dosya adı. Veriler, projeyle ilişkili depoya kaydedilir. Yeni bir varlık yaratılırken dosya adı varlık adından türetilir, ancak farklı olabilir. Dosyaya doğrudan erişmek istiyorsanız, bir dosya adı belirtebilirsiniz. Bir varlığın üzerine yazılırken bu parametre yoksayılır.

      Verileri bir dosyaya nasıl saklayacağınızı gösteren bir örnek:

      # Import the lib
      library("ibmWatsonStudioLib")
      wslib <- access_project_or_space(list("token"="<ProjectToken>"))
      
      # let's assume you have a data frame df which contains the data
      # you want to save as a csv file
      csv <- capture.output(write.csv(df, row.names=FALSE), type="output")
      csv_raw <- charToRaw(paste0(csv, collapse='\n'))
      wslib$save_data("my_asset_name.csv", csv_raw)
      
      # the function returns a list which contains the asset_name, asset_id, file_name and additional information upon successful saving of the data
      
  • upload_file(file_path, asset_name = NULL, file_name = NULL, overwrite = FALSE, mime_type = NULL)

    Bu işlev, yürütüm sırasında dosya sistemindeki verileri projenizle ilişkili bir dosyaya kaydeder.

    İşlev aşağıdaki parametreleri alır:

    • file_path: (Gerekli) Dosya sistemindeki dosyanın yolu.

    • asset_name: (İsteğe bağlı) Yaratılacak veri varlığının adı. Varsayılan olarak, karşıya yüklenecek dosyanın adına ayarlanır.

    • file_name: (İsteğe bağlı) Projeyle ilişkili depoda yaratılan dosyanın adı. Varsayılan olarak, karşıya yüklenecek dosyanın adına ayarlanır.

    • overwrite: (İsteğe bağlı) Depoda var olan bir dosyanın üzerine yazar. Varsayılan değer yanlış (false) olarak ayarlanır.

    • mime_type: (İsteğe bağlı) Yaratılacak varlık için MIME tipi. Varsayılan olarak, MIME tipi varlık adı sonekinden saptanır. Varlık adlarını sonek olmadan kullanıyorsanız, burada MIME tipini belirtin. Örneğin, düz metin verileri için mime_type='application/text' . Bir varlığın üzerine yazılırken bu parametre yoksayılır.

      Aşağıda, bir dosyayı projeye nasıl yükleyebileceğinizi gösteren bir örnek verilmiştir:

      # Import the lib
      library("ibmWatsonStudioLib")
      wslib <- access_project_or_space(list("token"="<ProjectToken>"))
      
      # Let's assume you have downloaded a file and want to save it
      # in your project.
      download.file("https://some/url/data_file.csv", "data_file.csv")
      wslib$upload_file("data_file.csv")
      
      # The function returns a list which contains the asset_name, asset_id, file_name and additional information upon successful saving of the data.
      

Bağlantı bilgilerini al

Belirli bir bağlantının bağlantı meta verilerine erişmek için aşağıdaki işlevi kullanabilirsiniz.

  • get_connection(name_or_item)

    Bu işlev, bağlantı veri kaynağından veri almak için kullanabileceğiniz bir bağlantının özelliklerini (meta verilerini) döndürür. Özellikleri görüntülemek için wslib$show(connprops) seçeneğini kullanın. İade edilen liste öğesindeki "." özel anahtarı, bağlantı varlığıyla ilgili bilgi sağlar.

    İşlev aşağıdaki zorunlu parametreyi alır:

    • name_or_item: Bir bağlantının adını taşıyan bir dizgi ya da list_connections()tarafından döndürülen öğeler gibi bir öğe.

    Not defterleriyle çalışırken, örneğin, bir bağlantıdan panellere veri yüklemek üzere kod oluşturmak için Kod parçacıkları panosunda Verileri oku seçeneğini tıklatabilirsiniz.

Bağlantılı veri bilgilerini al

Bağlı bir veri varlığının meta verilerine erişmek için aşağıdaki işlevi kullanabilirsiniz.

  • get_connected_data(name_or_item)

    Bu işlev, temel bağlantının özellikleri de içinde olmak üzere, bağlı bir veri varlığının özelliklerini döndürür. Özellikleri görüntülemek için wslib$show() seçeneğini kullanın. İade edilen listedeki özel anahtar "." , veriler ve bağlantı varlıkları hakkında bilgi sağlar.

    İşlev aşağıdaki zorunlu parametreyi alır:

    • name_or_item: Bağlı bir veri varlığının adını içeren bir dizgi ya da list_connected_data()tarafından döndürülmüş olanlar gibi bir öğe.

    Not defterleriyle çalışırken, örneğin, bağlı bir veri varlığından bir panda DataFrame ' e veri yüklemek üzere kod oluşturmak için Kod parçacıkları panosunda Verileri oku seçeneğini tıklatabilirsiniz.

Varlığa ad yerine tanıtıcı temelinde erişim

Veri varlıklarına ve bağlantılarına her zaman benzersiz bir adla erişmeniz gerekir. Varlık adlarının her zaman benzersiz olması gerekmez ve ibm-watson-studio-lib işlevleri bir ad belirsiz olduğunda kural dışı durum verir. Çakışmayı çözmek için kullanıcı arabiriminde veri varlıklarını yeniden adlandırabilirsiniz.

Varlıklara benzersiz bir tanıtıcıyla erişim mümkündür, ancak tanıtıcılar yalnızca yürürlükteki projede geçerli olduğundan ve farklı bir projeye aktarıldığında kodu bozacağı için kullanılması önerilmez. Bu durum, örneğin, projeler dışa aktarılıp yeniden içe aktarıldığında oluşabilir. İlgili liste işlevini (örneğin, list_connections()) kullanarak bir bağlantının, bağlı ya da saklanmış veri varlığının tanıtıcısını alabilirsiniz.

wslib$by_id giriş noktası aşağıdaki işlevleri sağlar:

  • get_connection(asset_id)

    Bu işlev, bağlantı varlığı tanıtıcısıyla bir bağlantıya erişir.

  • get_connected_data(asset_id)

    Bu işlev, bağlı veri varlığı tanıtıcısına göre bağlı bir veri varlığına erişir.

  • load_data(asset_id, attachment_type_or_item = NULL)

    Bu işlev, varlık tanıtıcısını aktararak bir depolanan veri varlığının verilerini yükler. Geçirebileceğiniz diğer parametrelere ilişkin bir açıklama için bkz. load_data() .

  • save_data(asset_id, data, overwrite = NULL, mime_type = NULL, file_name = NULL)

    Bu işlev, varlık tanıtıcısını aktararak verileri depolanan bir veri varlığına kaydeder. Bu, overwrite=TRUEanlamına gelir. Geçirebileceğiniz diğer parametrelerin açıklaması için bkz. save_data() .

  • download_file(asset_id, file_name = NULL, attachment_type_or_item = NULL)

    Bu işlev, varlık tanıtıcısını aktararak bir depolanan veri varlığının verilerini karşıdan yükler. Geçirebileceğiniz diğer parametrelerin açıklaması için bkz. download_file() .

Proje depolamasına doğrudan erişin

Proje depolamasından verileri getirebilir ve wslib$storage giriş noktasını kullanarak proje varlıklarını eşitlemeden proje depolamasında verileri depolayabilirsiniz.

wslib$storage giriş noktası aşağıdaki işlevleri sağlar:

  • fetch_data(filename)

    Bu işlev, bir dosyadaki verileri bayt arabelleği olarak döndürür. Dosyanın veri varlığı olarak kaydedilmesi gerekmez.

    İşlev aşağıdaki zorunlu parametreyi alır:

    • filename: Projedeki dosyanın adı.
  • store_data(filename, data, overwrite = FALSE)

    Bu işlev, bellekteki verileri depolamaya kaydeder, ancak yeni bir veri varlığı oluşturmaz. İşlev, dosya adını, dosya yolunu ve ek bilgileri içeren bir liste döndürür. Bilgileri yazdırmak için Use wslib$show() kullanın.

    İşlev aşağıdaki parametreleri alır:

    • filename: (Gerekli) Proje depolamasındaki dosyanın adı.
    • data: (Gerekli) İşlenmemiş nesne olarak kaydedilecek veriler.
    • overwrite: (İsteğe bağlı) Önceden varsa, saklama alanındaki bir dosyanın verilerinin üzerine yazar. Varsayılan olarak, false olarak ayarlanır.
  • download_file(storage_filename, local_filename = NULL)

    Bu işlev, saklama alanındaki bir dosyadaki verileri aşağı yükler ve belirtilen yerel dosyada saklar. Önceden varsa, yerel dosyanın üzerine yazılır.

    İşlev aşağıdaki parametreleri alır:

    • storage_filename: (Gerekli) Karşıdan yüklenecek depodaki dosyanın adı.
    • local_filename: (İsteğe bağlı) Yürütme ortamınızın yerel dosya sisteminde dosyayı karşıdan yükleyen dosyanın adı. Depolama dosyası adını kullanmak için bu parametreyi atlayın.
  • register_asset(storage_path, asset_name = NULL, mime_type = NULL)

    Bu işlev, dosyayı depolama alanına projenizdeki bir veri varlığı olarak kaydeder. Aynı ada sahip bir veri varlığı zaten varsa bu işlem başarısız olur. save_data () ile karşıya yükleyemeyeceğiniz çok büyük dosyalarınız varsa bu işlevi kullanabilirsiniz. Büyük dosyaları doğrudan projenizin IBM Cloud Object Storage saklama kabına (örneğin, kullanıcı arabirimi aracılığıyla) yükleyebilir ve register_asset()kullanarak bunları veri varlıkları olarak kaydedebilirsiniz.

    İşlev aşağıdaki parametreleri alır:

    • storage_path: (Gerekli) Saklama alanındaki dosyanın yolu.
    • asset_name: (İsteğe bağlı) Yaratılacak varlığın adı. Varsayılan değer olarak dosya adını kullanır.
    • mime_type: (İsteğe bağlı) Yaratılacak varlık için MIME tipi. Varsayılan olarak, MIME tipi varlık adı sonekinden saptanır. Dosya adınızın dosya uzantısı yoksa ya da farklı bir MIME tipi ayarlamak istiyorsanız MIME tipi belirtmek için bu parametreyi kullanın.
    Not: Bir dosyayı farklı bir veri varlığı olarak birkaç kez kaydedebilirsiniz. Projedeki bu varlıklardan birinin silinmesi depodaki dosyayı da siler; bu, dosyaya yönelik diğer varlık başvurularının bozulabileceği anlamına gelir.

Kıvılcım desteği

wslib$spark giriş noktası, depolama alanındaki dosyalara Spark ile erişmek için işlevler sağlar.

wslib$spark giriş noktası aşağıdaki işlevleri sağlar:

  • provide_spark_context(sc)

    Spark desteğini etkinleştirmek için bu işlevi kullanın.

    İşlev aşağıdaki zorunlu parametreyi alır:

    • sc: SparkContext. Not defteri çalıştırma zamanında sağlanır.

      Aşağıdaki örnekte Spark desteğinin nasıl ayarlandığı gösterilmektedir:

      library(ibmWatsonStudioLib)
      wslib <- access_project_or_space(list("token"="<ProjectToken>"))
      wslib$spark$provide_spark_context(sc)
      
  • get_data_url(asset_name)

    Bu işlev, depolamadaki bir dosyaya Hadooparacılığıyla Spark 'tan erişmek için bir URL döndürür.

    İşlev aşağıdaki zorunlu parametreyi alır:

    • asset_name: Varlığın adı.
  • storage.get_data_url(file_name)

    Bu işlev, depolamadaki bir dosyaya Hadooparacılığıyla Spark 'tan erişmek için bir URL döndürür. İşlev, varlık adını değil, dosya adını bekler.

    İşlev aşağıdaki zorunlu parametreyi alır:

    • file_name: Proje depolamasındaki bir dosyanın adı.

Proje varlıklarına göz at

wslib$assets giriş noktası, herhangi bir tipteki varlıklara soysal, salt okunur erişim sağlar. Seçilen varlık tipleri için, ek veri sağlayan özel olarak ayrılmış işlevler vardır.

Aşağıdaki adlandırma kuralları geçerlidir:

  • list_<something> adlı işlevler, adlandırılmış listelerin bir listesini döndürür. İçerilen her liste bir varlığı temsil eder ve varlığı tanımlayan küçük bir özellik kümesi (meta veriler) içerir.
  • get_<something> adlı işlevler, varlığın özelliklerini içeren tek bir adlandırılmış liste döndürür.

Bir listeyi ya da adlandırılmış listelerin listesini oldukça yazdırmak için wslib$show()adresini kullanın.

İşlevler, bir varlığın adını ya da parametre olarak listedeki bir öğeyi bekler. Varsayılan olarak, işlevler kullanılabilir varlık özelliklerinin yalnızca bir alt kümesini döndürür. raw_info=TRUEdeğiştirgesini ayarlayarak, varlık özelliklerinin tam kümesini alabilirsiniz.

wslib$assets giriş noktası aşağıdaki işlevleri sağlar:

  • list_assets(asset_type, name = NULL, query = NULL, selector = NULL, raw_info = FALSE)

    Bu işlev, verili kısıtlar bakımından, belirtilen tipe ilişkin tüm varlıkları listeler.

    İşlev aşağıdaki parametreleri alır:

    • asset_type: (Gerekli) Listelenecek varlıkların tipi; örneğin, data_asset. Kullanılabilir varlık tiplerinin bir listesi için bkz. list_asset_types() . Projedeki tüm kullanılabilir varlıkların listesi için asset varlık tipini kullanın.

    • name: (İsteğe bağlı) Listelenecek varlığın adı. Aynı ada sahip birden çok varlık varsa bu parametreyi kullanın. Yalnızca name ve querybelirtilebilir.

    • query: (İsteğe Bağlı) Varlıkları aramak için Watson Veri API 'sine iletilen bir sorgu dizgisi. Yalnızca name ve querybelirtilebilir.

    • selector: (İsteğe bağlı) Aday varlık listesi öğelerinde özel bir süzgeç işlevi. Seçici işlevi TRUEdeğerini döndürürse, varlık döndürülen varlık listesine eklenir.

    • raw_info: (İsteğe bağlı) Kullanılabilir meta verilerin tümünü döndürür. Varsayılan olarak, parametre FALSE olarak ayarlanır ve özelliklerin yalnızca bir alt kümesi döndürülür.

      list_assets işlevini kullanma örnekleri:

      # Import the lib
      library("ibmWatsonStudioLib")
      wslib <- access_project_or_space(list("token"="<ProjectToken>"))
      
      # List all assets in the project
      all_assets <- wslib$assets$list_assets("asset")
      wslib$show(all_assets)
      
      # List all data assets with name 'MyFile.csv'
      assets_by_name <- wslib$assets$list_assets("data_asset", name = "MyFile.csv")
      
      # List all data assets whose name starts with "MyF"
      assets_by_query <- wslib$assets$list_assets("data_asset", query = "asset.name:(MyF*)")
      
      # List all data assets which are larger than 1MB
      sizeFilter <- function(asset) asset$metadata$size > 1000000
      large_assets <- wslib$assets$list_assets("data_asset", selector = sizeFilter, raw_info = TRUE)
      wslib$show(large_assets)
      
      # List all notebooks
      notebooks <- wslib$assets$list_assets("notebook")
      
  • list_asset_types(raw_info = FALSE)

    Bu işlev, kullanılabilir tüm varlık tiplerini listeler.

    İşlev aşağıdaki parametreyi alabilir:

    • raw_info: (İsteğe bağlı) Meta verilerin tam kümesini döndürür. Varsayılan olarak, parametre FALSE olur ve özelliklerin yalnızca bir alt kümesi döndürülür.
  • list_datasource_types(raw_info = FALSE)

    Bu işlev, kullanılabilir tüm veri kaynağı tiplerini listeler.

    İşlev aşağıdaki parametreyi alabilir:

    • raw_info: (İsteğe bağlı) Meta verilerin tam kümesini döndürür. Varsayılan olarak, parametre FALSE olur ve özelliklerin yalnızca bir alt kümesi döndürülür.
  • get_asset(name_or_item, asset_type=None, raw_info = FALSE)

    İşlev, bir varlığın meta verilerini döndürür.

    İşlev aşağıdaki parametreleri alır:

    • name_or_item: (Zorunlu) Varlığın ya da list_assets() tarafından iade edilenler gibi bir parçanın adı.

    • asset_type: (İsteğe bağlı) Varlığın tipi. name_or_item parametresi, varlığın adı için bir dizgi içeriyorsa, asset_type ayarı gereklidir.

    • raw_info: (İsteğe bağlı) Meta verilerin tam kümesini döndürür. Varsayılan olarak, parametre FALSE olur ve özelliklerin yalnızca bir alt kümesi döndürülür.

      list_assets ve get_asset işlevlerini kullanma örneği:

      notebooks <- wslib$assets$list_assets("notebook")
      wslib$show(notebooks)
      
      notebook <- wslib$assets$get_asset(notebooks[[1]])
      wslib$show(notebook)
      
  • get_connection(name_or_item, with_datasourcetype=False, raw_info = FALSE)

    Bu işlev, bir bağlantının meta verilerini döndürür.

    İşlev aşağıdaki parametreleri alır:

    • name_or_item: (Gerekli) list_connections() tarafından döndürülen bağlantıya ya da öğeye benzer bir öğeye ilişkin ad
    • with_datasourcetype: (İsteğe bağlı) Bağlantının veri kaynağı tipiyle ilgili ek bilgi döndürür.
    • raw_info: (İsteğe bağlı) Meta verilerin tam kümesini döndürür. Varsayılan olarak, parametre FALSE olur ve özelliklerin yalnızca bir alt kümesi döndürülür.
  • get_connected_data(name_or_item, with_datasourcetype=False, raw_info = FALSE)

    Bu işlev, bağlı bir veri varlığının meta verilerini döndürür.

    İşlev aşağıdaki parametreleri alır:

    • name_or_item: (Gerekli) Bağlı veri varlığının ya da list_connected_data() tarafından iade edilenler gibi bir öğenin adı.
    • with_datasourcetype: (İsteğe Bağlı) İlişkili bağlı veri varlığının veri kaynağı tipiyle ilgili ek bilgi döndürür.
    • raw_info: (İsteğe bağlı) Meta verilerin tam kümesini döndürür. Varsayılan olarak, parametre FALSE olur ve özelliklerin yalnızca bir alt kümesi döndürülür.
  • get_stored_data(name_or_item, raw_info = FALSE)

    Bu işlev, saklanan bir veri varlığının meta verilerini döndürür.

    İşlev aşağıdaki parametreleri alır:

    • name_or_item: (Gerekli) Saklanmış veri varlığının adı ya da list_stored_data() tarafından iade edilenler gibi bir öğe.
    • raw_info: (İsteğe bağlı) Meta verilerin tam kümesini döndürür. Varsayılan olarak, parametre FALSE olur ve özelliklerin yalnızca bir alt kümesi döndürülür.
  • list_attachments(name_or_item_or_asset, asset_type=None, raw_info = FALSE)

    Bu işlev, bir varlığın eklerinin listesini döndürür.

    İşlev aşağıdaki parametreleri alır:

    • name_or_item_or_asset: (Gerekli) list_stored_data() ya da get_asset()tarafından iade edilenler gibi bir varlığın ya da parçanın adı.

    • asset_type: (İsteğe bağlı) Varlığın tipi. Varsayılan olarak data_assettipine ayarlanır.

    • raw_info: (İsteğe bağlı) Meta verilerin tam kümesini döndürür. Varsayılan olarak, parametre FALSE olur ve özelliklerin yalnızca bir alt kümesi döndürülür.

      Bir depolanan veri varlığının ekini okumak için list_attachments işlevini kullanma örneği:

      assets <- wslib$list_stored_data()
      wslib$show(assets)
      
      asset <- assets[[1]]
      attachments <- wslib$assets$list_attachments(asset)
      wslib$show(attachments)
      buffer <- wslib$load_data(asset, attachments[[1]])
      

Üst konu: IBM-watson-studio-lib Olanağının Kullanılması

Generative AI search and answer
These answers are generated by a large language model in watsonx.ai based on content from the product documentation. Learn more