Proje bilgilerini getir

Projeyle ilgili bilgileri programlı olarak getirmek için aşağıdaki işlevleri kullanabilirsiniz.

• 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_metadata()

  Bu işlev, proje meta verilerini döndürür.

• get_storage_metadata()

  Bu işlev, projeyle ilişkili nesne deposunun meta verilerini döndürür.

• get_project_bucket_name()

  Bu işlev, ilişkili nesne deposunda proje paketi adını döndürür. Tüm proje dosyaları bu saklama kabında saklanır.

• get_files()

  Bu işlev, projenizdeki dosyaların bir listesini döndürür. Döndürülen listedeki her öğe, dosyanın tanıtıcısını ve adını içerir. Döndürülen dosyaların listesi herhangi bir ölçüte göre sıralanmaz ve işlevi yeniden çağırdığınızda değişebilir.

• get_assets()

  Bu işlev, tüm proje varlıklarının listesini döndürür. İsteğe bağlı assetType değiştirgesini, varlıkları tipe göre süzmenize olanak sağlayan get_assets işlevine geçirebilirsiniz. Bu parametre için kabul edilen değerler: data_asset, connection ve asset. asset değeri, projenizdeki tüm varlıkları döndürür. Örneğin, yalnızca veri varlıklarını almak için get_assets("data_asset")işlevini kullanın.

• get_connections()

  Bu işlev, projenizdeki bağlantıların bir listesini döndürür. Döndürülen listedeki her öğe, bağlantının tanıtıcısını ve adını içerir.

Dosyaları getir

Projenizle ilişkili nesne deposunda saklanan dosyaları getirmek için aşağıdaki işlevleri kullanabilirsiniz.

Dosyaları iki şekilde getirebilirsiniz:

• get_file_url(filename) burada filename , getirmek istediğiniz dosyanın adıdır.

  Bu işlev, Spark kullanarak nesne deposundan bir dosyayı almak için URL ' yi döndürür. URL, projeyle ilişkili nesne depolama tipine dayalı olarak oluşturulur. Hadoop yapılandırmaları, projenizin nesne depolamasıyla etkileşimde bulunduğunuzda otomatik olarak ayarlanır.

  Aşağıdaki örnekte, Spark kullanarak nesne deposundan veri almak için bu işlevin nasıl kullanılacağı gösterilmektedir:

  # Import the lib
  library(projectLib)
  project <- projectLib::Project$new(sc, "<ProjectId>", "<ProjectToken>")
  
  # Get the url
  url <- project$get_file_url("myFile.csv")
  
  # Fetch the CSV file from the object storage using Spark
  invisible(sparkR.session(appName = "SparkSession R"))
  
  df.data <- read.df(
      url,
      source = "org.apache.spark.sql.execution.datasources.csv.CSVFileFormat",
      header = "true")
  head(df.data)
  

• get_file(filename) burada filename , getirmek istediğiniz dosyanın adıdır.

  Bu işlev, çalışan çekirdeğin belleğine bir dosya getirir. İşlev, çekirdeğe özgü veri yapılarına (örneğin, bir R veri çerçevesine) bağlanmak için kullanılabilecek bir bayt arabelleği döndürür. Bu dosya getirme yöntemi çok büyük dosyalar için önerilmez.

  Aşağıdaki örnek, bir dosyanın nasıl getirileceğini ve verilerin bir R veri çerçevesine nasıl okunacağını göstermektedir:

  # Import project lib
  library(projectLib)
  project <- projectLib::Project$new(sc , "<ProjectId>", "<ProjectToken>")
  
  # Fetch data
  my.file <- project$get_file("my_file.csv")
  
  # Read the CSV data file into a data frame
  df.data <-  read.csv(text = rawToChar(my.file))
  head(df.data)
  

Verileri kaydetme

Projenizle ilişkili nesne deposuna veri kaydetmek için aşağıdaki işlevi kullanabilirsiniz. Veriler, ilişkili Cloud Object Storageiçindeki proje deposuna bir dosya olarak eklenecektir. Bu işlev birden çok şey yapar. İlk olarak, verileri nesne deposuna koyar ve daha sonra projenize veri varlığı olarak bu verileri ekler; böylece, projenizdeki veri varlıkları listesinde dosya olarak kaydettiğiniz verileri görebilirsiniz.

save_data(filename, data, setProjectAsset=TRUE, overwrite=FALSE)

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

• filename: yaratılan dosyanın adı.
• data: karşıya yüklenecek veriler. Bu değiştirge için kabul edilen tipler R ham nesneleri ya da dizgi arabellekleridir.
• setProjectAsset[optional]: veriler nesne deposuna başarıyla yüklendikten sonra dosyayı veri varlığı olarak projeye ekler. Bir boole değeri alır ve true değeri varsayılan olarak ayarlanır.
• overwrite[optional]: Dosya, nesne deposunda ya da projede zaten varsa dosyanın üzerine yazılır. Varsayılan olarak false olarak ayarlanır.

Aşağıda, verileri nesne deposunda bir dosyaya nasıl saklayabileceğinizi gösteren bir örnek verilmiştir:

library("projectLib")
project <- access_project()

# Capture CSV data from console output
csv_lines <- capture.output(write.csv(df.data, row.names=FALSE), type="output")
csv_raw <- charToRaw(paste0(csv_lines, collapse='\n'))

project$save_data("file.csv", csv_raw)

Bağlantıdan veri okuma

Belirli bir bağlantının meta verilerini (kimlik bilgilerini) almak için aşağıdaki işlevi kullanabilirsiniz.

get_connection: İşlev, bağlantının tanıtıcısını ya da adını giriş olarak alır. Bu değerleri, projede listelenen tüm varlıkların id, name ve type değerlerini döndüren get_assets() işlevini kullanarak alabilirsiniz.

get_connection işlevi, bağlantı veri kaynağından veri almak için kullanabileceğiniz bağlantı kimlik bilgilerini döndürür.

Aşağıda, get_connection işlevini kullanarak bir bağlantının kimlik bilgilerini nasıl alabileceğinizi gösteren bir örnek verilmiştir:

# Import project lib
library(projectLib)
project <- projectLib::Project$new(sc , "<ProjectId>", "<ProjectToken>")

# Fetch connection
conn.cred <- project$get_connection(name="<ConnectionName>")

Bağlantınız dashDB ile bağlantıysa, aşağıdaki kodu çalıştırarak verilerinizi alabilirsiniz:

library(ibmdbR)

props <- paste("DASHDB;DATABASE=BLUDB;HOSTNAME=", conn.cred$host, ";PORT=50000;PROTOCOL=TCPIP;", sep="")
conn <- idaConnect(props, uid = conn.cred$username, pwd = conn.cred$password, conType = "odbc")
idaInit(conn)

idf.1 <- ida.data.frame('<TableName>')
head(idf.1)

Bağlı verileri getir

Bağlı verilerin kimlik bilgilerini almak için aşağıdaki işlevi kullanabilirsiniz. İşlev, o bağlantıdaki belirli verileri gösteren bir datapath özniteliğine ek olarak bağlantı kimlik bilgilerini de içeren bir sözlük döndürür; örneğin, bir dashDB örneğindeki bir tablo ya da Cloudant eşgörünümündeki bir veritabanı.

get_connected_data: Bu işlev, bağlı verilerin tanıtıcısını ya da bağlı verilerin adını giriş olarak alır. Bu değerleri, projede listelenen tüm varlıkların id, name ve type değerlerini döndüren get_assets() işlevini kullanarak alabilirsiniz.

Aşağıda, get_connected_data işlevini kullanarak dashDB eşgörünümündeki bağlı verilerin kimlik bilgilerini nasıl getireceğinizi gösteren bir örnek verilmiştir:

# Import project lib
library(projectLib)
project <- projectLib::Project$new(sc , "<ProjectId>", "<ProjectToken>")

# Fetch credentials of the connected data
conn.data <- project$get_connected_data(id="<ConnectedDataId>")

Üst konu: Not defterindeki verileri yükleme ve verilere erişme