https://github.com/nathanmarz/cascalog
Data processing on Hadoop without the hassle.
https://github.com/nathanmarz/cascalog
Last synced: about 1 year ago
JSON representation
Data processing on Hadoop without the hassle.
- Host: GitHub
- URL: https://github.com/nathanmarz/cascalog
- Owner: nathanmarz
- License: other
- Created: 2010-03-31T00:40:07.000Z (over 16 years ago)
- Default Branch: develop
- Last Pushed: 2023-05-18T22:49:55.000Z (about 3 years ago)
- Last Synced: 2025-04-11T18:23:56.540Z (about 1 year ago)
- Language: Clojure
- Homepage:
- Size: 2.3 MB
- Stars: 1,376
- Watchers: 79
- Forks: 176
- Open Issues: 40
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-java - Cascalog
README
# Cascalog
[](http://travis-ci.org/nathanmarz/cascalog)
[Cascalog](http://cascalog.org/) is a fully-featured data processing and querying library for Clojure or Java. The main use cases for Cascalog are processing "Big Data" on top of Hadoop or doing analysis on your local computer. Cascalog is a replacement for tools like Pig, Hive, and Cascading and operates at a significantly higher level of abstraction than those tools.
Follow the getting started steps, check out the tutorial, and you'll be running Cascalog queries on your local computer within 5 minutes.
# Getting Started with JCascalog
To get started with JCascalog, Cascalog's pure-Java API, see [this wiki page](https://github.com/nathanmarz/cascalog/wiki/JCascalog). The jcascalog.Playground class has in-memory datasets that you can play with to learn the basics.
# Latest Version
The latest release version of Cascalog is hosted on [Clojars](https://clojars.org):
[](https://clojars.org/cascalog/cascalog-core)
# Getting started with Clojure Cascalog
The best way to get started with Cascalog is experiment with the toy datasets that ship with the project. These datasets are served from memory and can be played with purely from the REPL. Just follow these steps and you'll be on your way:
1. Install [leiningen](http://github.com/technomancy/leiningen)
2. Make sure you have Java 1.6 (run `java -version`)
3. Start a new leiningen project with `lein new `, replacing ``
4. Include dependency on Cascalog in your project by adding `[cascalog/cascalog-core "2.1.0"]` into your project's `project.clj` file.
5. Work through the examples in the [Getting Started Guide](http://cascalog.org/articles/getting_started.html).
# Using Cascalog within a project
Cascalog is hosted at [Clojars](http://clojars.org/cascalog), and some of its dependencies are hosted at [Conjars](http://conjars.org/). Both Clo/Con-jars are maven repos that's easy to use with maven or leiningen.
To include Cascalog in your leiningen or cake project, add the following to your `project.clj`:
General
[cascalog/cascalog-core "3.0.0"] ;; under :dependencies
[org.apache.hadoop/hadoop-core "1.2.1"] ;; under :dev-dependencies
Leiningen 2.0
:repositories {"conjars" "http://conjars.org/repo"}
:dependencies [cascalog/cascalog-core "3.0.0"]
:profiles { :provided {:dependencies [[org.apache.hadoop/hadoop-core "1.2.1"]]}}
Leiningen < 2.0
:dependencies [cascalog/cascalog-core "3.0.0"]
:dev-dependencies [[org.apache.hadoop/hadoop-core "1.2.1"]]
Note that Cascalog is compatible with Clojure 1.2.0, 1.2.1, 1.3.0, 1.4.0, and 1.5.1.
# Documentation and Issue Tracker
- The [Cascalog website](http://cascalog.org/) contains more information and links to Various articles and tutorials.
- API documentation can be found at http://nathanmarz.github.io/cascalog/.
- [Issue Tracker on Github](https://github.com/nathanmarz/cascalog/issues).
Come chat with us in the Google group: [cascalog-user](http://groups.google.com/group/cascalog-user)
Or in the #cascalog or #cascading rooms on freenode!
# Priorities for Cascalog development
1. Replicated and bloom joins
2. Cross query optimization: push constants and filters down into subqueries when possible
# Acknowledgements
YourKit is kindly supporting open source projects with its full-featured Java Profiler. YourKit, LLC is the creator of innovative and intelligent tools for profiling Java and .NET applications. Take a look at YourKit's leading software products: [YourKit Java Profiler](http://www.yourkit.com/java/profiler/index.jsp) and [YourKit .NET Profiler](http://www.yourkit.com/.net/profiler/index.jsp).
Cascalog is based off of a very early branch of cascading-clojure project (http://github.com/clj-sys/cascading-clojure). Special thanks to Bradford Cross and Mark McGranaghan for their work on that project. Much of that code appears within Cascalog in either its original form or a modified form.