W MongoDB $ln Operator potoku agregacji oblicza logarytm naturalny (ln ) liczby i zwraca wynik w postaci podwójnej.
Składnia
Składnia wygląda tak:
{ $ln: }
Gdzie
Przykład
Załóżmy, że mamy kolekcję o nazwie test z następującym dokumentem:
{ "_id" :1, "dane" :0.5 }{ "_id" :2, "dane" :20 }{ "_id" :3, "dane" :200 }
Możemy użyć $ln operator zwracający logarytm naturalny danych pole:
db.test.aggregate( [ { $match:{ _id:{ $in:[1, 2, 3 ] } } }, { $project:{ _id:0, data:1, wynik:{ $ln:[ "$dane" ] } } } ]) Wynik:
{ "dane" :0.5, "wynik" :-0.6931471805599453 }{ "dane" :20, "wynik" :2.995732273553991 }{"dane" :200, "wynik" :5.298317366548036}
Innym sposobem na zrobienie tego byłoby użycie $log operator z drugim argumentem Math.E . Zobacz MongoDB $log na przykład.
Logarytm naturalny
Logarytm naturalny liczby to jej logarytm do podstawy stałej matematycznej e , gdzie e to irracjonalna i transcendentalna liczba, która zaczyna się od 2.7182818284590452353602874713527 i trwa w nieskończoność.
Stała matematyczna e jest również znany jako liczba Eulera.
W JavaScript możemy użyć Math.E do reprezentowania e . Możemy zatem uzyskać logarytm naturalny z e za pomocą Math.E jako argument przy użyciu $ln .
Załóżmy, że mamy taki dokument:
{ "_id" :4, "dane" :2.718281828459045 }
Pole danych zawiera e do 15 miejsc po przecinku.
W tym przykładzie użyto dwóch sposobów na zwrócenie logarytmu naturalnego e :
db.test.aggregate( [ { $match:{ _id:{ $in:[ 4 ] } } }, { $project:{ _id:0, e_1:{ $ln:[ "$data " ] }, e_2:{ $ln:[ Math.E ] } } } ]) Wynik:
{ "e_1" :1, "e_2" :1 }
Pierwszy wynik wykorzystuje dane z dokumentu. Dla drugiego wyniku używamy Math.E wygenerować e .
Tak czy inaczej, wynik to 1 .
Wartości poza zakresem
Jak wspomniano, $ln operator akceptuje dowolne prawidłowe wyrażenie, które rozwiązuje do liczby nieujemnej. Wartości spoza tego zakresu spowodują błąd.
Załóżmy, że do naszej kolekcji dodamy następujący dokument:
{ "_id" :5, "dane" :-20 }
Uruchommy $ln operatora względem tego dokumentu:
db.test.aggregate( [ { $match:{ _id:{ $in:[ 5 ] } } }, { $project:{ _id:0, data:1, wynik:{ $ln:[ "$dane" ] } } } ]) Wynik:
Niewłaściwy typ danych
Podanie nieprawidłowego typu danych również spowoduje błąd.
Załóżmy, że do naszej kolekcji dodamy następujący dokument:
{ "_id" :6, "dane" :"Dziesięć" }
Uruchommy $ln operatora względem tego dokumentu:
db.test.aggregate( [ { $match:{ _id:{ $in:[ 6 ] } } }, { $project:{ _id:0, data:1, wynik:{ $ln:[ "$dane" ] } } } ]) Wynik:
nieprzechwycony wyjątek:Błąd:polecenie nie powiodło się:{ "ok" :0, "errmsg" :"$ln obsługuje tylko typy numeryczne, nie łańcuchowe", "code" :28765, "codeName" :"Location28765"} :agregat nie powiodło się :[email protected]/mongo/shell/utils.js:25:[email protected]/mongo/shell/assert.js:18:[email protected]/mongo/shell/assert.js:639:[email protected]/mongo/shell/assert.js:729:[email protected]/mongo/shell/db.js:266:[email protected]/mongo/shell/collection.js:1058:12@ (powłoka)::1:1
Dostarczyliśmy ciąg, więc komunikat o błędzie mówi nam, że $ln obsługuje tylko typy numeryczne, a nie ciągi .
Wartości puste
Wartości null zwracają null podczas korzystania z $ln operatora.
Załóżmy, że do naszej kolekcji dodamy następujący dokument:
{ "_id" :7, "dane" :null }
Uruchommy $ln operatora względem tego dokumentu:
db.test.aggregate( [ { $match:{ _id:{ $in:[ 7 ] } } }, { $project:{ _id:0, data:1, wynik:{ $ln:[ "$dane" ] } } } ]) Wynik:
{ "dane" :null, "wynik" :null }
Widzimy, że wynikiem jest null .
Wartości NaN
Jeśli argument ma postać NaN , $ln zwraca NaN .
Przykład:
db.test.aggregate( [ { $match:{ _id:{ $in:[1] } } }, { $project:{ _id:0, data:1, wynik:{ $ln:[ "$dane" * 1 ] } } } ]) Wynik:
{ "dane" :0.5, "wynik" :NaN } Nieistniejące pola
Jeśli $ln operator jest stosowany do pola, które nie istnieje, null jest zwracany.
Przykład:
db.test.aggregate( [ { $match:{ _id:{ $in:[1] } } }, { $project:{ _id:0, data:1, wynik:{ $ln:[ "$wiek" ] } } } ]) Wynik:
{ "dane" :0.5, "wynik" :null }
W tym przypadku próbowaliśmy zastosować $ln w polu o nazwie wiek , ale to pole nie istnieje w dokumencie, więc otrzymujemy null .
